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Preface 


This is the second volume of the Owner's Handbook, Preface 
“Additional Information and Advanced Concepts.” Owner's 

Handbook IT contains a variety of things, such as the Client 

Tracking system, chapters on Convert and Backup modes, 

technical data, a glossary, reinstallation, and crash recovery 

procedures. Much of the information is reference material on 

specific topics. 


Owner's Handbook II is paired with Owner's Handbook I, 
“Working with Cornerstone.” Volume I covers the major 
uses of the system. 


The examples in this volume frequently refer to the Sample 
Database, Client Tracking system, and Sales database, all of 
which are included with Cornerstone. 


In this Owner's Handbook we have highlighted key concepts 
with ac> pointing hand =2in the margin. =] 


Paragraphs printed like this one describe minor details or other points 
that you may want to skip. 


An index for both volumes of the Owner’s Handbook is 
included at the end of this volume. 
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The Client Tracking System 3 


Client Tracking 
System 


The Client Tracking system is a database designed to keep | Introduction 
track of people, companies, and contacts with clients. A 
“client” can be anyone with whom you do business, such 

as Suppliers, customers, or patients. The Client Tracking 
system takes advantage of Cornerstone’s variable-length 
records and text-handling capabilities to keep a detailed 
history of all contacts with these individuals or 
organizations. In the Client Tracking system, you may have 
many pages of notes for long-established clients, but just a 
few lines for new clients. You can search the client histories 
for a particular word or phrase; for example, you can find 
the client with whom you discussed bartending robots in 
1982. 


The Client Tracking system has many other uses. You can 
use it to produce mailing labels, keep an up-to-date phone 
directory of friends and business contacts, remind you 
whom to contact next, and list upcoming birthdays and 


anniversaries. 

This chapter assumes a modest familiarity with Installing the 
Cornerstone. If you haven't yet used Cornerstone, you Client Tracking 
would benefit from reading the Beginner's Guide or System 


chapter 2 in Owner's Handbook I before continuing here. 
How to Run Client Tracking 


Two-diskette system: Use a copy of the diskette labeled 
“Client Tracking” as your data diskette. Insert the Client 
Tracking diskette in drive A and a formatted blank diskette 
in drive B, then enter 


A)COPY «.« B: 
A)DEL B:«.SLS 
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Using the Client 
Tracking 
System 


Label the Client Tracking diskette copy; this is the data 
diskette you'll be using. Store the original Client Tracking 
diskette in a safe place. To run the Client Tracking system, 
insert the Client Tracking diskette copy in drive A, insert 
‘the Cornerstone system diskette in drive B, and enter 
| A)CORNER 
| Hard-disk system: The Client Tracking system application 
| is in the directory \CORNER\ CLIENT. To run it, enter 


C)CD \.CORNER 
| C)CORNER CLIENT 


What You Have 
The Client Tracking system contains two files: People and 
Client Tracking. 


The People file contains basic information about individuals, 

| such as their names, addresses, telephone numbers, 
birthdays, and anniversaries. It can also include professional 
information such as company name and address, and job 
title. You can also add notes (up to several pages long) and 

| keyword references for each person. The figure below 
shows a sample record from the People file. 
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The Client Tracking System 


Select a command from the menu. Use arrow keys or type the command. 


x] UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 





VIEW PEOPLE 8 Records NOT SORTED 








}) Marcia Andrews Easy Charters 
59 Eliot Street Senior Agent 
Brookline, MA 02146 111 Federal Street 
USA Boston, MA02110 
Home Phone 617-443-6536 Work Phone’ 617-222-2225 
Birthday April4 
Anniversary June6b 
Professional 
References: 


Notes: Lived in Chicago before moving into this job in January 1984 
Die-hard Chicago Cubs fan 


Craig Bandlick Kilobite Sandwich Shoppes 
64 Meadow Brook Road Vice-President 

Providence, RI 02243 111 Beacon Street 

USA Wickford, Al 02852 


File’ PEOPLE Previous mode Initial Files viewed: | 


The Client Tracking file keeps a detailed history of all your 
contacts with the client. It contains the names, phone 
numbers, and titles of individuals within the organization, 
the date of the last call, the date of the next scheduled call, 
and the source of the original contact. The figure below 
shows some of the sample data from the Client Tracking file. 


+) 
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Select a command from the menu. Use arrow keys or type the command 
a} UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 
VIEW CLIENT__TRACKING 3 Records NOT SORTED 


) Kilobite Sandwich Shoppes, Inc 
111 Beacon Street 
Wickford, RI 02852 














Contacts 
Craig Bandlick 603-324-8591 Vice-President 
History 
11/26/84 Had funch with Craig today, Small business — only three stores 


at present. Wants a copier at each location. 


12/07/84 Met with Craig to discuss specific models. He is interested in 
buying 3 of the UX-80's. Cali him next friday with price quote 


ee Ss sss SS——— 
File. CLIENT_TRACKING Previous mode: Initial Files viewed: 1 


Both files come with sample data to demonstrate the report 
formats and selection criteria we've created. When you're 
ready to use the Client Tracking system for your own 
information, delete all the records from both files, then 

add your data. 


Adding Data 

The Client Tracking system is a two-file database that takes 
advantage of Cornerstone’s relational capabilities. This 
doesn’t mean that you have to use all these capabilities. The 
People file can be used by itself, if you choose, to replace 
your current phone directory or Rolodex Desk Top File® 
system. The Client Tracking file can also be used by itself, 
after making one minor modification, mentioned below. 
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The Client Tracking System 


After deleting the sample data, add your own information 
about individuals to the People file. The Client Tracking 
system can be used for both personal and business 
purposes, so you can add records to the People file for 
friends and relatives, as well as for business associates. 
Don’t bother to add a work address for companies that will 
be in your Client Tracking file, as this can be inserted by 
Cornerstone. See the section below, Tips on Using Client 
Tracking. 


Second, enter information about your clients in the Client 
Tracking file. Include whatever historical information you 
feel is important in the Contact History section. 


As the system is defined, you can’t add a contact person to 
the Client Tracking file unless a record for that person exists 
in the People file. (This ensures consistency of information 
throughout.) To use the Client Tracking file by itself, remove 
this restriction, as described in the section Personalizing 
Your Client Tracking System. 


The most time-consuming aspect of using the Client 
Tracking system will be entering your existing information. 
(If it’s in another computer program, you may be able to use 
the Convert utility to move it into Cornerstone. See the 
next chapter, “The Convert Utility.”) Entering the data is a 
one-time activity—the time you'll save in the future will 
more than reward the initial effort. 


Once you have entered your current Rolodex-type 
information, most new data entry will be in the Client 
Tracking file. Each time you contact a particular client, or he 
contacts you, update that client's record in the Clent 
Tracking file by entering a new note. Add new individuals or 
change records as necessary in the People file. 
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Using the 
Pre-Defined 
Reports 


Each file has been supplied with formats for viewing, 
updating, and selecting information. A few selection criteria 
have also been included. This section describes how to use 
these formats and selection criteria to produce reports. The 
easiest way to learn about them is to use them. Remember, 
in View mode nothing you do can affect the data 1n your 
files, so feel free to experiment with the formats and 


| selection criteria. 





Mailing Labels 
With the Client Tracking system you can generate mailing 
labels in a number of different ways. The following 
instructions show how to print labels in a few cases, and 
demonstrate the general approach. Consult the section 
Personalizing Your Client Tracking System for other ideas. 
O VIEW PEOPLE 
O USE SELECTION-CRITERIA PERSONAL Or PROFESSIONAL if 
you wish to restrict the mailing to one of these groups. 
USE FORMAT HOME_MAILING_LABELS or 
BUSINESS_MAILING_LABELS as appropriate to print the 
home or work address. 


O 


O PRINT PRINTER. Both mailing label formats have been 
set up for labels that are 6 lines long. If your labels are 
of a different length, issue the command PRINT SETUP 
from View mode, and change Number of lines per page 
to the number of lines on your mailing labels. 


Checking Upcoming Birthdays and Anniversaries 

If you enter birthday and anniversary information into the 
People file, the Client Tracking system will remind you when 
it’s time to run to the store. 
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The Client Tracking System 


O VIEW PEOPLE 
O USE FORMAT DATES 
QO SELECT-BY-FORM, entering the name of the desired 
month(s) in the Birthday or Anniversary fields. 
O Press (DONE) twice. 
See All Information in the People File 


Issue the following commands to display all the information 
in the People file, using a pre-designed format. 


O VIEW PEOPLE 
O USE FORMAT FULL_INFO 
Checking Whom to Call 


You can use the Client Tracking system to remind yourself 
whom to call, and when. Here’s how: 


O VIEW CLIENT TRACKING 

O USE FORMAT TICKLER 
Checking the Full Client History 
Issue the following commands to display all of the 
information from the Client Tracking file. 

O VIEW CLIENT TRACKING 

O USE FORMAT FULL_INFO 


The Client Tracking system has been designed as a general- 
purpose system useful for a wide variety of applications. You 
may wish to tailor the system to your needs once you 
become familiar with it. 


This section offers a few ideas for possible changes. You 
should refer to the chapters “Planning Your Database” and 
“Defining Your Database” in Owner's Handbook I for a more 
detailed discussion of database design. 


Personalizing 
Your Client 
Tracking 
System 
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You use Define mode to make changes to the definitions of 
files and attributes (as opposed to using Update mode to E— 
change your data). From Define mode you can change the 

names of attributes, delete attributes you no longer want, 
and add new attributes to fit your needs. You can even add a 
new file to your database. 


I 


_A Patient Tracking System 

An example will serve to illustrate many of the types 

_ of changes you can make to the Client Tracking system. 
Suppose you are a doctor, have purchased Cornerstone, and 
want to use the Client Tracking system to keep track of your 
| patients. Each time you see a patient you want to enter a 
note containing the date, the purpose of the visit, the tests 
or procedures administered, and what medication you 
prescribed. The basic structure parallels the Client Tracking 
system, but you clearly need to make some changes. 


"1 
i a 








i 








These changes fall into three categories: 
O Changing file information 


O Changing attribute information—deleting unnecessary 
attributes and adding new ones 


(Fat lS 


© Establishing appropriate relationships between the files 


File Changes 

You would probably need just two files, People and Patient 
Alistory (your version of the Client Tracking file). People 
could hold information about your patients, such as their 
names, addresses, insurance coverage, and whom to 


” 








contact in an emergency. The Patient History file would 
keep the medical histories. You can also use the People file | <a 
to keep track of individuals who are not patients. If you only — 
want to use the database for patients, all the information E 
could be combined in one file. — 
a 
k 
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The Client Tracking System 


Before changing the individual attributes, let's rename the 
Client Tracking file. To do this, issue the command 
REDEFINE-FILE CLIENT _TRACKING 
FIRST-FILE-INFO-THEN-ATTRIBUTES 


Cornerstone presents you with a form to edit in which you 
can change the name to Patient History. After changing the 
name, press (DONE). 


Since your patients are individuals, not companies, you also 
want to remove the relationship between Company Name in 
the People file and Company Name in the Patient History file. 
To do so, enter 


REMOVE-RELATIONSHIP PEOPLE 


Later on, after you have made all the other changes, you will 
re-establish a relationship between the two files. Press 
(DONE) to return to Top Level in Define mode. 


Attribute Changes 
You can delete many attributes from the People file, 
such as Birthday, Birthday Month, Anniversary, and 
Anniversary Month. Issue the commands 
REDEFINE-FILE PEOPLE 
DELETE-ATTRIBUTE BIRTHDAY 


Use DELETE-ATTRIBUTE to delete the other attributes as 
well. To add a new attribute, such as Insurance Coverage, 
issue the command DEFINE-NEW-ATTRIBUTE and complete 
the attribute definition form. (See the chapter “Defining 
Your Database” in Owner's Handbook I for more 


information. ) 
You can delete a couple of attributes from Patient History as 


well, such as Current Status and Source of Lead. (Both might 
also be adapted for use by a physician. ) The subrecord 


1] 
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Tips on Using 
Client Tracking 


Contact People is also unnecessary, but a relatic mship exists 
between it and the People file. You must remove this 


_ relationship before you can delete Contact People. To do this, 


issue the commands 
REDEFINE-ATTRIBUTE CONTACT PEOPLE 
(DONE) 
REMOVE-RELATIONSHIP PEOPLE 
(DONE) 


Once this is done, you can delete Contact People. 


A variety of other changes are possible. You can change 
Company Name to Name, and Contact History to Visits. (Use 
REDEFINE-ATTRIBUTE to make the changes.) You would 


| undoubtedly add more information to the Visits subrecord as 





well, such as Medication and Test Results. To do this, issue 
the commands 


REDEFINE-ATTRIBUTE VISITS 

(DONE) 
to get to Subfile level. There you can use DEFINE-NEW- 
SUBATTRIBUTE to add subattributes to the Visits subfile. 


Re-establishing Relationships 

As a last step, you need to re-establish a relationship 
between the two files. The attribute Fill Name in the People 
file should be related to the attribute Name in the Patient 
History file. Just enter REDEFINE-FILE for either file, select 
DEFINE-RELATIONSHIP, and name the other file and the 
appropriate attributes. 


The Client Tracking system was designed to be used by 
different people in different ways. As a result, we made 
certain trade-offs and compromises in its design. The 
following discussion describes these trade-offs, and 
suggests directions for change. 
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The Contact People Restriction 

If you want to use the Client Tracking system exclusively to 
keep track of clients (if you’re not interested in retaining any 
personal information in the People file), you can eliminate 
the People file entirely. That way you need not enter a new 
record in the People file before you can enter a new contact 
in the Chent Tracking file. 





‘To do this, first remove the relationship between the files, 
then delete the People file. As a last step, change the 
definitions of the attributes that were formerly derived 
(Phone Number and Job Title in the Contact People 
subrecord). Since these are no longer derived, change them 
to type String. 


If you want to keep both files but want to enter new clients 
without having to first add them to the People file, you can 
eliminate the restriction of Contact People to the People file 
without deleting the People file. From the Top level of Define 
mode enter: 

REDEFINE-FILE CLIENT_TRACKING 

REDEFINE-ATTRIBUTE CONTACT_PEOPLE 

(DONE) 

REDEFINE-SUBATTRIBUTE NAME 


Move the cursor to the Restrict values to file field and erase 
the restriction: People. Full_Name. 


The Company Name Relationship 
A relationship exists between the Company Name attributes 
in the People and Client Tracking files. You can use the 
relationship to view all the people from a particular company. 
From Initial mode, issue the commands 

VIEW CLIENT_TRACKING 

VIEW PEOPLE 

ONLY-RELATED-RECORDS CURRENT-RECORD 
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Company Name in neither file is restricted to values in the 
other file. This has pros and cons. On the positive side, if all 


| you want to do is enter someone's business card, you can 


add all the information in the People file. On the negative 
side, since Cornerstone does no checking, you can 
accidentally type the company name differently in each file. 


In addition, since you can enter company information into 
either file, information cannot be derived from one source. 
When you update a client's address, it’s not automatically 


| reflected in the People file. But Cornerstone provides 


another path to the same end. You can use the UTILITIES 


| RECOMPUTE command (in Initial mode) to pull current 








company address information from the Client Tracking file to 
existing records in the People file. This command asks you 
to specify which attributes to recompute, and you can name 
all of the address attributes at one time. See chapters 4 and 
5 for more information about RECOMPUTE. 


If you require a more structured database, and are willing to 
tolerate more rigid data entry restrictions, consider adding a 
third file: Companies. This file would hold basic company 
information and be related by Company Name to both People 
and Client Tracking. Restrict Company Name in both the 
People and Client Tracking files to values in this new file. 


Other Tips 

The Reference attribute in the People file is useful for 
identifying people whose names you might otherwise forget. 
For example, if you enter “Plumber” in a person’s record 
then, at some later date, as the water from the sink 
approaches your oriental rugs, you won't have to remember 


your plumber’s name. Just select “Plumber” from the People 
file. 
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You may want to supply your own enumerated values for the 
Current Status attribute in the Client Tracking file. You 
might use values such as “Friend,” “Business Associate,” 
and “Deadbeat.” Use this attribute to select clients of a 
particular status, such as “Deadbeats.” 


You can use the Last Contact Date attribute to select clients 
you haven't contacted since a particular date. 


The following is a list of the files and attributes in the Client | Detailed 
Tracking database, with a brief description where necessary. | Description of 
Detailed descriptions are also provided in the files Files 

themselves, and can be printed using the PRINT command in 

Define mode. 


People File 
First Name. 
Last Name. 


Full Name. Automatically combines First Name and 
Last Name. Each full name must be unique, and is 
mandatory. A relationship is defined between this 
attribute and the Name subattribute of Contact People 
in the Client Tracking file. 


Home Street Address. Multi-valued. Can contain 
more than one line. 


Home City. 
Home State. 


Home Zip Code. Defined as a string since you don’t 
do any computations with zip codes. Restricted to five 
characters in length. If nine-digit zip codes are 
required, use REDEFINE-ATTRIBUTE to change the 
length restriction. 
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Country. Nation part of home address. 


Home CSZ. A derived attribute that combines City, 
State, and Zip Code into one attribute. Useful for 
generating mailing labels. 


Home Phone. Multi-valued. Can enter more than one 
telephone number. 


Birthday. Person’s birthday. Enter just the month and 
day if you don’t know the year. The pre-defined 
selection format only looks at the month. 


Anniversary. Person’s anniversary. Similar to 
Birthday. 


Birthday Month. Uses the TEXT_ MONTH function 
to derive the name of the month entered in Birthday. 
Used in the selection form. 


Anniversary Month. Equivalent to birthday month. 


Personal or Professional. Multi-valued attribute 
used to group individuals into one (or both) categories. 
You may want to create your own categories. Useful for 
selection. 


Company Name. A relationship exists between the 
Company Name here and in the Client Tracking file. 


Company Street Address. Initialized to the first 
value of the address from the Client Tracking file. 


Company City. Initialized to the value from the Client 
Tracking file. 


Company State. Initialized to the value from the 
Client Tracking file. 
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Company Zip. Initialized to the value from the Client 
Tracking file. 


Company CSZ. Equivalent to Home CSZ. Combines 
City, State, and Zip Code in one line for use in mailing 
labels. 


Job Title. Multi-valued. 
Work Phone. Multi-valued. 


References. Multi-valued attribute that can be used 
for keyword references, such as “Computer Types,” 
“Bridge Player,” and “Party Enthusiast.” Useful for 
selection. 

Notes. Multi-valued attribute for entering whatever 
notes you want. Can be up to several pages long. 


Client Tracking File 


Company Name. Company Name is mandatory and 
must be unique. A relationship is defined between this 
attribute and the Company Name attribute in the 
People file. 


Company Address. Street address for the company. 
Multi-valued. 


City. City part of company address. 
State. State part of company address. 
Zip Code. Zip code part of company address. 


Company CSZ. Combined City, State, and Zip Code 
for mailing labels. 
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Contact People. Subrecord containing information 
about individuals within the client organization. |= 
Contains the following subattributes: 


= Name. Full name of person. A relationship -E 
exists between the name here and in the People —= 
file. As set up, the name must exist in the , 
People file before it can be entered here. ie 

« Phone Number. Work phone number derived te 

from the People file (first value only). EF 
« Title. Job title derived from the People file (first E ry, 

value only). 

Contact History. Subrecord used for entering notes ga a 


about each contact with the client. Consists of the _" 
following subattributes: 


« Notes. Multi-valued attribute for entering notes a 
about the contact. 


« Date. The current date is automatically entered, — 
but you may change it as necessary. 

[x] Notes has been defined as a multi-valued attribute to allow you to enter y — 
the maximum amount of information. Here's how it works: When you = 
press (ENTER) after adding a note, room is created for the next value 
within the current subrecord. Pressing (ENTER) again moves the cursor 


to the Date field to allow you to change the date associated with the a 
subrecord. Pressing (ENTER) again starts the next subrecord where you > 
can either add data or press (ENTER) twice to exit the entire subform. 


Two things to remember: (1) If you've finished with the record you can 
press the (DONE) key at any point. (2) The status line always displays the is 





current subrecord and attribute name. 


Last Contact. The most recent date entered in the . 
Contact History subrecord. E = 
=~ 
Date to Call. Date to contact the organization. Used SS 
| 


by the 7ickler format. 5 
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The Client Tracking System 


Current Status. Enumerated attribute used to 
differentiate classes of clients. A few generic values 
have been supplied: initial contact, excellent prospect, 
active client, and inactive client. You will probably want 
to change these or add your own. 


Source of Lead. Initial source of contact. 


Formats and Selection Criteria for the People File 


C 





Format View, the default View mode format, gives you 
a basic telephone directory displaying name, home 
phone, and work phone. 


Format Full Info displays all the data that has been 
entered for the individual. 


Format Dates displays name, birthday, and 
anniversary. 

Format Home Mailing Labels displays name and home 
address laid out for a stx-line mailing label. 


Format Business Mailing Labels displays name, job 
title, company name, and company address laid out for 
a six-line mailing label. 

Selection criteria Personal selects those records with 
the value “personal” for the Personal or Professional 
attribute. 


Selection criteria Professional selects those records 
with the value “Professional” for the Personal or 
Professional attribute. 
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Formats and Selection Criteria for the Client 
Tracking File 
© Format View, the default View mode format, displays 
the company names, date of last contact, and date of 
next scheduled contact, sorted alphabetically. (If you 
have a large number of companies you may want to re- 


save without the sort. ) = 


O Format Full Info displays all information from the 
records. 

© Format Tickler displays Company Name, Date to Call, \ = 
and names and phone numbers for the contact people 
in the organization. This report is sorted by date to 
call. 














HAPTER__ 


THE CONVERT 


UTILITY 





Aa A en a i 


22 The Convert Utility 





CHAPTER 2 


CONTENTS 


Getting Started 


23 


MailMerge Files | 25 


PFS Files 
dBASE Il Files 
1-2-3 and Other 
Spreadsheet 
Files 

DIF Files 

SDF Files 

TEXT Files 


Customization 


Conversion 
Errors 


Processing a 
File 


Analyzing Data 





Al 
60 


61 


75 











The Convert Utility 23 


The Convert Utility 


The Convert utility (Convert mode) allows you to export data | Getting Started 
in Cornerstone files to other software products, such as 

word processors and spreadsheets, and to wmport data from 

other programs to Cornerstone. 


If you're not familiar with Cornerstone, you should gain 
some experience with the system before converting any of 
your files. Otherwise, you may end up with unanticipated 
results. Don’t try to convert large files right away; try out 
the conversion procedure on a small sample file first. In 
addition, you may wish to make a backup copy of your 
database before converting from foreign file formats. 


Which Formats You Can Convert 
Convert mode lets you export Cornerstone files to the 
following foreign (non-Cornerstone) formats: 





1-2-3 The internal format of 1-2-3™ files. 

MailMerge MailMerge® files (mailing lists). 

DIF DIF™ (Data Interchange Format) 
files, used by many graphics and 
spreadsheet programs. 

SDF SDF (Standard Data Format) files 


(ASCII files with fixed length 
records and fields), used by many 
mainframe databases. 





2A The Convert Utility 











SE eee 


The Convert utility lets you import foreign files in all the 
formats listed above, and: 
<2 Loh 3 Sievert 1 ake Se eS 


| dBASE Il The internal format of dBASE I® 


files. (ABASE III® files cannot be 
directly converted. ) 








PFS The internal format of PFS®: File 
files. 

TEXT ASCII files with customized 
characteristics. 





The Kinds of Conversions You Can Perform 
You can perform three kinds of conversions: 


O Export Cornerstone data to a new foreign file 


Import foreign data into a new Cornerstone file 


Oo 


Oo 


Import foreign data into an existing Cornerstone file 
You cannot add any data to an existing foreign file. 


Plan Your Conversion Strategy 
Converting files with Cornerstone is a simple process, 
but one that requires some planning. We suggest you read 


| chapter 9 in Owner's Handbook I, “Planning Your Database,” 


before you convert your data. 


The best way to learn Convert mode Is to use it, so we'll 
guide you through some typical conversions. You may read 
them all, or skip directly to the sections for your particular 
file type. 


From Initial mode, you can issue the UTILITIES CONVERT 
command to enter Convert mode. 
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DOS File Names 

During the conversion, you will be asked to type in the 
name of a DOS file. When appropriate, include the drive 
(A: or C:) and full directory path name. Be sure to include 
the proper extension to the name. 


If you have a two-diskette system, all source and destination 
files must be located on the data diskette in drive A. 
Therefore, you need only type in NAME.EXT. (In the 
sample command lines, A: can be omitted. ) 


Don’t Forget (HELP) 

Take advantage of Cornerstone’s on-line Help facility. Press 
the (HELP) key whenever you're uncertain about what to do 
next. 


How This Chapter is Organized 

The next sections guide you through some sample 
conversions for the various file types. The later sections of 
the chapter contain reference information. The section 
Customization covers some features provided to make your 
conversion work easier. Conversion Errors discusses some 
common problems. Processing a File explains what goes on 
behind the scenes of a conversion. Analyzing Data describes 
what happens to data before and after it is converted. 


The MailMerge format is used by many mailing list MailMerge Files 
programs and word processors. The following two sections 
describe conversion to and from the MailMerge file format. 


Exporting To a MailMerge File 
This example shows you how to convert a Cornerstone file 
into a file in the MailMerge format. 
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For this example, we'll use the Sample Database to generate 
a MailMerge file. Let’s assume you want to send certain 
customers a form letter produced with a word processor. 
You want to have customer names and addresses from your 
Customer file automatically inserted in the letters to 
selected customers. The MailMerge format is expressly 
designed for this use. 


First, you must decide what data you want to export. In this 
case, all you want is name and address information. Start 
Cornerstone, and enter View mode with the Customer file. 
Use the DETAILED or COLUMN commands to create a format 
containing the attributes Name, Street, City, State, and Zip. 
You may want to sort the records, for example, if you want 
your letters ordered by zip code. Save the format under the 
name MailList. 


You could also create selection criteria, for example, to 
select all the customers in one state. For this example, we 
will omit selection criteria. 


You're now ready to start the conversion. If you have a two- 
diskette system, leave the data diskette in drive A. If you 
have a hard-disk system, you can export to the hard disk or 
the floppy-diskette drive. For these examples, use a 
formatted diskette in drive A. 


Issue the ALL-DONE to return to Initial mode, and enter 

the command UTILITIES CONVERT. Cornerstone now enters 
Convert mode, Select the CONVERT command. Cornerstone 
prompts you to select a series of options, including the name 
of the file you are exporting to (the destination file), the 
name of the Cornerstone source file, the name of the saved 
format to use, and (optionally) the name of the saved 
selection criteria to use. 


For this example, enter: 





| 






| 


a 


ila 


The Convert Utility 


CONVERT TO MAILMERGE 
A: MAILLIST. MMG CUSTOMER MAILLIST 


When you press (ENTER), Cornerstone starts converting the 
records of the source file. To halt the conversion at any time, 
press (CANCEL). After the conversion is finished, the number 
of records processed and the number of errors, if any, 
appear in the data window. 


If any errors occurred, they are listed in the DOS file 
MAILLIST.ERR. You can look at the errors by exiting 
Cornerstone and typing the DOS file. See the sections 
Customization, and Conversion Errors, for more 
information. 


To see the result of your conversion, exit Cornerstone and 
enter the DOS command TYPE A:MAILLIST.MMG. The 
screen below shows the MailMerge file. 


“Newton Auto Rentals”, 75 Monroe”, "Newton, "MA", “02210-1387~ 

"Lange's Motorworld”, "52 Pierce Rd ~, "Watertown", “MA”, "02150-9992" 
"Watertown Car Center”, 620 Hubbard Ave.~, “Watertown”, "MA", "02150-9992" 
“Bergman's Antique Autos” “285 Hill”, “Cambridge”, “MA”, °24017-9991" 
"Medford Motor Service”, "975 Abbey Rd.”, “Medford™, “MA”, "17013-999*" 
“Roman Olds Dealers”, “510 Silverdale”, “Cambridge”, “MA”, °24017-9591" 
“Tosh's Service Center”. "334 Norwell”, “Cambridge”, “MA”, "24017-9991" 
"Roxbury Auto Body and Repair”, “910 Penn Blvd”, “Roxbury”, "MA", "18422-9998" 
"Hal's Foreign Auto Repair”, "362 Boston Ave“, “Boston”, MA”, “27205-99937 
“Lexington Auto Service”, "800 Sesame”, “Lexington”, "MA", "01853-9998" 
"Concord Bus Line”, "210 Congress”, “Cambridge”. “MA™, “24017-99937 

"T Motors”, “650 Rider's Rd. “Cambridge”. "MA", “24017-9931” 

"Hanover Service Station”, "180 Lacore Ave ~, “Boston”, “MA”, "27205-9993" 
"Bunker Hill Garage”, “995 Pauline”, “Boston”, “MA”, "27205-3993" 

“Cambridge Commons Cab Co.", "10 Madison”, “Cambridge”, "MA", 24017-3991" 


PH | 
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Your particular word processing or mailing list program will 
| tell you how to use your new MailMerge file. 


Importing a MailMerge File 
| The first example of a MailMerge file shows conversion 
| to anew Cornerstone file. The second example shows 
conversion into an existing Cornerstone file. 


You will need a sample MailMerge file to import if you wish 
to follow the sample conversion. You can import the 
MailMerge mailing list data created in the previous section. 
(Or, if you have not done the export to a MailMerge file, 
create a sample MailMerge file to import. ) 


| Begin the conversion by starting up Cornerstone. Put the 
diskette containing the MailMerge file MAILLIST. MMG 
| in drive A. For two-diskette systems, the MailMerge file 
should be on the same diskette as your Cornerstone data. 
From Initial mode, enter the command UTILITIES CONVERT. 





| Enter the CONVERT command, and Cornerstone prompts 
you for the name of the file you are importing (the source 
file), whether to put the converted data in a new file or an 
existing one, and the name of the Cornerstone destination 
file. In this example, we'll bring the MailMerge data into a 
new Cornerstone file, called Names&A ddresses. 


CONVERT FROM MAILMERGE 
A: MAILLIST. MMG NEW-FILE NAMES&ADDRESSES 


When Cornerstone converts from a foreign format, it 
analyzes a sample record in the source file in order to 
establish a plan for the conversion. Cornerstone then gives 
you a form to edit that lets you modify this plan. The screen 
below shows this form for our example. 











NI. 


ween 


“a7 


§ 


ff ie 


"| 
ft 


‘il 


fait 


fl, 


J 


' 


- 
i 
_ 





The Convert Utility 


Enter values into the form 
EDIT 1st Attribute.Attribute Name STRING OVS 


NEW-FILE conversion form. 








Attribute Name Attribute Type Include in transfer? 
Newton_Auto_Rentals STRING Yes 

AT5_ Monroe STRING Yes 

Newton STRING Yes 

MA STRING Yes 

A02210__ 1387 STRING Yes 

File Previous mode: Convert Files viewed: 


Cornerstone doesn’t know what names to assign to the 
attributes, so it uses the values from the sample record. 


[x] The sample record is the first record in the file. Cornerstone reads this 
record into the conversion form. Be sure that the first record is not 
empty and has typical data for the file 





The names displayed in the form become the names of the 
attributes in your new Cornerstone file. You generally will 
want to edit these, for example changing “Newton_Auto_ 
Rentals” to “NAME,” and so on. (You can always change the 
names again in Define mode.) Changing the attribute names 
does not affect the records that will be converted. 


The second column, Attribute Type, lists the data types 

that Cornerstone will assign the new attributes. 7 It is = I 
important that you carefully check the attribute types, as 

these are not easily changed after the conversion. = 
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Convert mode goes by appearances only. For example, 
some strings, such as zip codes, may look like numbers. 


| You can also decide to omit individual fields from the new 





Cornerstone file. Under the heading “Include in Transfer?” 
you would type “No.” In this example, all fields will be 
included in the conversion. When you are finished editing 
the form, press (DONE). 


The final form is displayed below. 


Enter values into the form 
EDIT 5th Attribute.Attribute Name STRING OVS * 


NEW-FILE conversion form 
Attribute Name Attribute Type Include in transfor? 


STRING Yes 
STRING Yes 
STRING Yes 
STRING Yes 


Name 
Street 
City 
State 


ee _ 
File: Previous mode. Convert Files viewed 


When you are satisfied with the form, issue the CONTINUE 
command. Cornerstone starts converting the records of the 
source file. You can halt the conversion at any time by 
pressing (CANCEL). 
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You can see the results of your conversion by looking at 
the new Cornerstone file. Enter ALL-DONE, and then VIEW 
NAMES&ADDRESSES. The screen below displays three 
records of your new Cornerstone file. 


Selecta command fromthe menu Use arrow keys or type the command. 


fs] UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 


VIEW Names & Addresses 16Records NOT SORTED 


}} Name: Newton Auto Rentals 
Street: 75 Monroe 

City. Newton 

State MA 

Zip, 02210-1387 









Name: Lange's Motorworld 
Street. $2 Pierce Rd 

City: Watertown 

State. MA 

Zip 02150-9992 


Name, Watertown Car Center 
Street. 620 Hubbard Ave 

City: Waterlown 

State. MA 





Files: Names & Addresses Previous made. Initial Files viewed; 1 


The EXISTING-FILE Option for MailMerge 

The procedure for importing MailMerge data into an 
existing Cornerstone file is much like the previous 
procedure. In this case Cornerstone will append the 
converted data as new records at the end of your existing 
file. The main difference when converting to an existing file 
is that the data from the foreign source file must be matched 
to the corresponding attributes in the Cornerstone 
destination file. This is done by editing an EXISTING-FILE 
conversion form. 
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J ee ORES 


For this example, you can import the MailMerge mailing list 
data created in the earlier export example into the Customer 
file in the Sample Database. (Or, if you have not done the 
export example, create a sample MailMerge file to import. ) 


Enter the commands: 
UTILITIES CONVERT 
CONVERT FROM MAILMERGE 
A: MAILLIST. MMG EXISTING-FILE CUSTOMER 


The screen below displays your new conversion form. 

This form lets you match the order of the fields in your 
MailMerge source file with the order of the attributes in 
your existing Cornerstone file. The first column of the form 
shows the names of the existing Cornerstone attributes; the 
second column shows Cornerstone’s default matching of the 
attributes; and the third column shows their data types. 

v> Derived and subrecord attributes are sot shown, since 
you cannot import to them. = 


The number of input fields in the second column equals 

the number of fields in the MailMerge source file. You must 
decide which existing Cornerstone attribute will receive the 
data from the corresponding input fields in the source file. In 
this example, the original matching Is correct, so there is no 
need to make changes. If you wanted the Name data to go 
into the Contacts attribute, you would move the number “1” 
from the Name to the Contacts attribute. There can be more 
attributes in your Cornerstone file than there are fields in 
your source file. (Also, not every field in the input file must 
be imported to your Cornerstone file. ) 
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Enter values into the form, 
EDIT 1st Attribute.Attribute Name 
EXISTING-FILE conversion form 


STRING 








Attribute Name Input field number Type 
Cs | STRING 
STREET 2 STRING 

CITY 3 STRING 
STATE 4 STRING 

ZIP 5 STRING 
AREA_ CODE STRING 
PHONE STRING 

EXT STRING 
CONTACTS STRING 
TERMS ENUMERATED 
DISCOUNT NUMBER 

File Previous mode. Convert Files viewed: 


Press (DONE) when you've edited the form. Begin 
converting records with the CONTINUE command. 


Once the conversion is complete, you can see the new 


records. Enter View mode with the Customer file. This file 


now has 32 records, as opposed to its original 16 records. 
The last 16 records are your new ones. Many fields are 
blank, since there were no corresponding fields in the 


MailMerge file. The derived attributes (like Total Purchases) 
are filled in, with values derived from records in the Order 


file related to this customer name. 


[X] If you're wondering why Cornerstone allowed duplicate customer 


names, we told Cornerstone not to check for unique values during the 


conversion. See the section Customization. 
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If you want to return your Sample Database to its original 
pristine state, flag all the new records, then delete all 
flagged records with 


UPDATE FLAGGED 
DELETE ALL-UPDATE-RECORDS 


This section describes conversion from the PFS: File format. 
| You cannot export Cornerstone files directly to the 
PFS: File format. 


PFS Files 


man 


j 


You can import PFS data to a new Cornerstone file or into 
an existing Cornerstone file. It’s simpler to move your PFS 

| information into a new Cornerstone file, but by doing so you 
may not be taking full advantage of Cornerstone’s power and 
flexibility. When converting to a new file you cannot use the 
Enumerated data type or multi-valued attributes. You may 
prefer to design and build a Cornerstone file first, and then 
import your PFS data. 


fx] For two-diskette system users, when you import PFS files, your data 
diskette may not have enough space. While converting, if you get the 
message “Disk is full,” you will be unable to finish the conversion. You 
will need to delete a few files to make room for the PFS files. See 
chapter 10, “Reinstallation and Saving Space,” in this volume. 


tat as an 


‘it 


For the following examples, we work with a sample PFS file. 
Create a similar file to work through the examples yourself. 
For a two-diskette system, copy the file to the diskette with 
the Sample Database. If you are using a hard-disk system, 
save the PFS file on a diskette in drive A. The screen below 
displays a sample record from our PFS file called ta 
CUSTLIST. kK 
a 
SS 


: 
| 


Far 
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Neme: Cambridge Antique Autos 

Street: 44 Olde English Waye 

City: Cambridge State: MA Zip: 02138 
AreaCode: 617 Phone: 491-3454 

Notes: They specialize in parts for Bugattis 


To create a new Cornerstone file called Customer List with 
the information from the PFS file, enter the commands: 
UTILITIES CONVERT 
CONVERT FROM PFS 
A: CUSTLIST NEW-FILE CUSTOMER_LIST 


Cornerstone displays a form that shows how it will translate 
the PFS fields into Cornerstone attributes. The first column 
displays the new attribute names, the second column their 
data types, and the third column lets you tell Cornerstone 
whether to include the particular PFS field in the 
conversion. The figure below displays the conversion form 
for our example. 
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EDIT 9th Attribute.Include in transfer? BOOLEAN OVS * 


NEW-FILE conversion form, 


Attribute Name Attribute Type Include intransfer? | = 


ae 
Enter values into the form = 











Name STRING Yes | 
Street STRING Yes | 
City STRING Yes a ame 
State STRING Yes = 
Zip INTEGER Yes den, 
AreaCode INTEGER Yes | 
Phone STRING Yes 
Notes STRING Yes _ — 
ADDENDUM STRING fea, ote a E 
“=, 
] 
a 
File Previous mode: Convert Files viewed " 
You can edit this form as you would any other Cornerstone E— 
form. In this case Cornerstone used the PFS field names for 
the new attributes, so few changes are necessary. The last E ial 
attribute, Addendum, is used to hold any PFS addendum m4 
field you might have created. Cornerstone makes its best 
guess as to the appropriate data types for the new _ l 
attributes, based upon a sample record from the PFS file. _— 
In this case two changes are necessary: both Zip and a 
Area Code should be strings, not integers. Otherwise La : 
Cornerstone will drop leading zeroes, turning the zip code <p 
“02101” into “2101.” Edit the form to change the attribute bk 
type. The last column tells Cornerstone whether to include — 
the field in the conversion. If you have no Addendum, change ™ 
the value for this attribute to “No.” 3 
a 
hk 
as 
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When you are satisfied with the form, press (DONE). (You 
can edit it again with the EDIT command.) Enter CONTINUE 
to begin the conversion. Cornerstone will notify you of any 
errors during conversion. You can look at the errors by 
exiting Cornerstone and issuing the DOS command TYPE 
A:CUSTLIST. ERR. For more information about errors, see 
the sections Customization, and Conversion Errors. After 
you've corrected any problems, you can run the conversion 
again. 


The new Cornerstone file is displayed below, using the 
detailed format. Unlike PFS, with Cornerstone the way you 
look at your information (the report format) is separate from 
the file definition. As a result, Cornerstone gives you the 
ability to look at your information in an unlimited number of 
different formats. Cornerstone does not convert your PFS 
format, but you can easily re-create the same format, if 
necessary, with the REPORT FORMAT command. 


Select a command from the menu. Use arrow keys or type the command. 


3 UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 


VIEW Customer__List 2 Records NOT SORTED 


Name Cambridge Antique Autos 

Street: 44 Olde English Waye 

City Cambridge 

State. MA 

Zip: 02138 

AreaCode: 617 

Phone: 491-3454 

Notes: They specialize in parts for Bugattis. 





a 
File: Customer__List Previous mode; Initial Files viewed: | 
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Converting PFS to an Existing Cornerstone File at 
Converting a PFS file to an existing Cornerstone file is quite wt 
_ similar to converting to a new file. The main difference in 
| this case is that the data from the PFS source file must be 
| matched to the corresponding attributes in the Cornerstone =, 
| destination file. | 





For this example we'll add the data from the PFS file mms 
CUSTLIST to the Cornerstone file Customer. Enter the 
commands: 


iN 


J). 


UTILITIES CONVERT 
CONVERT FROM PFS 
A: CUSTLIST EXISTING-FILE CUSTOMER 


” 


The screen below displays a new form, used for matching 
the input fields of the PFS file to the Customer file in 
Cornerstone. The first column displays attribute names 
from the Customer file, and the last column displays the data 
types of these attributes. You can’t edit this last column, 
since it describes your existing file. The middle column, 
“Input Field Number,” assigns input fields from the PFS file 
to the Customer file attributes, since the items in one file 
may be in a different order than the items in the other file. 


aN 


= 


‘lat 
i 


ie ith 


i 
= 35 ee 





ow 


| 


ff 
| 


S 





iis 


i 


———4 


Ij 
ll 


i 


a 


Enter values into the form 


EDIT Ist Attribute.Attribute Name STRING ONES) 
EXISTING-FILE conversion form 

Attnbute Name Input field number Type 

J STRING 
STREET 2 STRING 
CITY 3 STRING 
STATE 4 STRING 
ZIP 5 STRING 
AREA__CODE 6 STRING 
PHONE 7 STRING 
EXT 8 STRING 
CONTACTS 9 STRING 
TERMS ENUMERATED 
DISCOUNT NUMBER 


EE 
File Previous made Convert Files viewed: 


In our example, the first seven input fields are already ina 
matched order. The eighth input field, Notes, is currently 
matched to the Ext attribute in the Cornerstone file. To 
change this, delete the “8” on that line, and insert an “8” on 
the line for the attribute Votes. (You'll have to scroll down a 
screen to reach this line). 

f] You can have more attributes in your Cornerstone file than there are 


fields in your PFS file. You cannot transfer more fields from your PFS 
file than there are attributes in the Cornerstone file. 
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[he figure below shows the edited form. 


Enter values into the form : i 
EDIT 9th Attribute.Input field number INTEGER ONES | 


EXISTING-FILE conversion form. 











Attribute Name Inputfieldnumber TPS Iieieks > fatno 6 
NAME } STRING —— 
STREET 2 STRING | = co 
CITY 3 STRING org | 
STATE 4 STRING 
2IP 5 STRING 3 
| AREA_CODE 6 STRING ‘ 
PHONE 7 STRING a 
EXT STRING Re 
CONTACTS ae STRING | 
TERMS ENUMERATED — 
DISCOUNT NUMBER cao 
NOTES 8 STRING ieee | 
K ad 
| 
File Previous mode: Convert Files viewed | 
; te . 
| When you've completed editing the form, press (DONE). ance 
Enter CONTINUE if the form is correct. When you enter i ; 
CONTINUE, Cornerstone begins the conversion. Cornerstone 
notifies you of any errors that occur during the conversion. If | = . 
necessary, look at the error file (CUSTLIST. ERR), and try ina 
again. For more information on errors, see Customization, 
| and Conversion Errors. | 
ee , Sa 
To see your new records, enter ALL-DONE, then VIEW 
CUSTOMER. Your new records are at the end of the file. The a 
figure below shows one new record. — 
“a 
4 
_ 
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Select a command fromthe menu Use arrow keys or type the command 


ee] UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 
VIEW CUSTOMER 18 Records NOT SORTED 









) NAME Cambridge Antique Autos 
STREET. 44 Olde English Waye 
CITY: Cambridge 

STATE: MA 

ZIP: 02138 

AREA CODE: 617 

PHONE. 491-3454 

EXT 

CONTACTS 

TERMS 

DISCOUNT 

NOTES They specialize in parts for Bugattis 
TOTAL PURCHASES: $ 0.00 
NUMBER OF ORDERS 0 
TOTAL UNITS 0 





File: CUSTOMER Previous mode: Initial Files viewed: | 


Converting to or from dBASE II files is similar to converting 
PFS files. Just remember to choose the dBASE II option 
when Cornerstone prompts you to select the foreign format. 
The data type definitions in dBASE Il are used by 
Cornerstone. If you have related files in dBASE II, when 
you import the files, you can define the relationships in 
Cornerstone. 


If you want to convert data from dBASE III, you should use 
standard file formats such as DIF or SDF. (If you do use DIF 
or SDF to convert dBASE III files, the data type definitions 
will not be retained. ) 


You can convert files from Cornerstone to 1-2-3, and vice 
versa. However, it’s important to realize that databases 
(such as Cornerstone), and spreadsheets (such as 1-2-3), 
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dBASE Il Files 


1-2-3 and Other 
Spreadsheet 
Files 
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} 
} 
sal 


look at information in quite different ways. We will discuss a ‘ 1 
number of hints and strategies that should help you make | — 
the best use of this conversion utility. * 
_ If you have another spreadsheet, such as Visicalc™™, tC 
| you will need to transfer files using the DIF format. On the in| 
| command line, substitute pir for 1-2-3 in the examples in this 7 
section. If you are using Symphony"", you can import and Suma 
export files from Cornerstone for use in Symphony with the iy 
1-2-3 option. sh 


The Sales Database 

We've prepared two Cornerstone database files to illustrate 
converting to and from 1-2-3. They are in a database called 

| Sales on your Client Tracking diskette (if you have a two- 

| diskette system), or in the directory \CORNER\.SALES 
| on your hard disk. 


- 
SH 





ha 


= 


vik 


Two-diskette system: There are two databases on the 
Client Tracking Copy diskette. Copy the Sales database to 
anew diskette. Put the Client Tracking Copy diskette in —~s 
drive A, anda blank formatted diskette in drive B. Then = 
enter the DOS commands: 


A)COPY *.« B: 


A)DEL B:*.DBF | 
4 


(You might label this diskette “Sales.”) 








To run Cornerstone with the Sales database, use Sales as kK 
your data diskette, and type: ty 
A)SALES . 
— 


Hard-disk system: The SALES subdirectory is in the 
CORNER directory. (If necessary, type the DOS command = 
CD \.CORNER. ) To use the Sales database, type: SS 


C)CORNER SALES kK 
— 
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Converting From Cornerstone to 1-2-3 

People often want to convert data from a database to a 
spreadsheet. Although databases can store, select, and 
report on large quantities of data, spreadsheets are better 
tools for other types of analysis. For example, Cornerstone 
is good for keeping track of actual sales figures, but 1-2-3 is 
better for projecting future sales. 


The Convert utility can transfer Cornerstone files to your 
1-2-3 spreadsheet. You can use saved formats and selection 
criteria to convert exactly the data you need. (Otherwise, 
you may find that your converted spreadsheet files are 
cluttered with unwanted data. ) 


In the Sales database, the file Product Orders contains 
information about orders for automotive parts. This file 
contains a subfile, called Line Items, which contains 
information about the individual parts ordered, such as list 
price, quantity, and total price. 


Let’s assume you periodically want to transfer sales 
summaries, the units sold, and the dollar totals for each 
product in a given month to a spreadsheet file. Two steps are 
involved in this process: creating saved selection criteria 
that select the appropriate records; and creating a saved 
format containing the appropriate data. 


To start, view the Live [tems file. Enter SELECT BY-FORM, 
and select only records that have order dates in the month of 
January (type “January 1984” in the Date field of the 
selection form). Press (DONE) to leave Edit mode, and save 
the new selection criteria with the command: 


SAVE SELECTION-CRITERIA JAN 


(We've already created selection criteria for you for 
February through June. ) 
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Press (DONE) to return to View mode with the appropriate 
records. The screen shows just the part numbers for the 
parts ordered in January. 


To create the appropriate format, first create a new report 
_ with subtotals for the quantity and prices for each part: 


COLUMN PRODUCT_NAME QTY PRICE 
REPORT SUBTOTAL SUM QTY SUM PRICE 


ff 


Cornerstone prompts you to select an attribute to group the 
| subtotals by. In this case, choose PRODUCT_NAME. Enter 
| YES ASCENDING for sorting. 


in 


| For the spreadsheet you only need the subtotals (you don't 
| want to analyze the individual orders), so issue the 
| command 


| eB 


REPORT HIDE RECORDS 


| 


: 7 
| 
to hide the records. The figure below shows the subtotal 
information we'll convert to the spreadsheet file. 
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Select a command from the menu. Use arrow keys or type the command. 





ane | UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 
US SES 18 Records SUBTOTALED = 
PRODUCT NAME ary PRICE 
Subtotals for Ball Bearings 
16 240,00 
Subtotals for Gasket 
254 127.00 
Subtotals for Wheel Lock 
75 1,875.00 
File LINE_ITEMS Previous mode: Initial Files viewed 1 


We'll need to save this format, so issue the command: 
SAVE FORMAT SALESFORMAT 


Press (DONE) to return to Initial mode. You’re now ready to 
convert your Line Items subfile. 


From Initial mode, issue the commands: 
UTILITIES CONVERT 
CONVERT TO 1-2-3 
A!SALES.WKS LINE_ITEMS SALESFORMAT JAN 


SALES.WKS is the 1-2-3 spreadsheet file that will receive 
the converted Cornerstone data. (If you have Symphony, 
name your file SALES.WRK, and use WRK in the 
examples where .WKS appears) 
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When you press (ENTER), the conversion begins. When it is 
complete, the number of records processed and the number |= I 
of errors, if any, are displayed on the screen. If any errors 

occurred during the conversion, exit Cornerstone and type 








| the error file (SALES. ERR). , = 
| 

| Once you exit Cornerstone you can run 1-2-3 and retrieve 
the Sales (SALES.WKS) file. |. = 
— 


Ball Bearings 16 240.00 " 
Gasket 254 127.00 
Wheel Lock 75 1,875.00 


#\-| 


AUTOMOTIVE PARTS DIVISION ae. 
| SALES 1984 _ . 


(units sold} 


A 

Actual Forecast Actual Forecast | 

Jan Jan Feb Feb 

a a gee te eee | =F | 

Ball Bearings 16) | “7 

Gasket 254 1 
Wheel Lock 75 


f 
i 
#15) 





“7 


H2| 


The new data appears in the upper-left corner of the 
| spreadsheet. Notice that the constant text “Subtotals for” 
was not transferred from the Cornerstone file. 


w 





The new data may not be situated in the most useful part of 
your spreadsheet. You can use another portion of the 
spreadsheet to set up a template, or report format, as in the 


= I 





~  , 
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| 


lower part of the screen shown. Use cell references (such as 
B1, B2, B3) to copy your data to the nicely formatted 
section of the spreadsheet, or reformat the data. 


You can use saved formats and selection criteria to 
periodically convert a set of summary numbers to your 
spreadsheet. Each conversion has to be to a new 1-2-3 file. 
For example, you could use the Feb selection criteria to 
convert data for the month of February. 
CONVERT TO 1-2-3 

A: SALESFEB.WKS LINE_ITEMS SALESFORMAT FEB 
(Again, if you are using Symphony, name your file 
SALESFEBWRK.) 


In 1-2-3, you can use the File Combine command to 
integrate your new file SALESFEB with SALES. See the 
screen displayed below. 





1 Ball Bearings 16 240.00 44 660.00 
2 Gaskets 254 127,00 1,290 645.00 
K) Wheel Lock 715 187500 . 67 1,675.00 
4 
5 
6 
7 
8 AUTOMOTIVE SALES DIVISION 

SALES 1984 

(units sold) 

Actual Forecast Actual Forecast 
Jan Jan. Feb. Feb 

Ball Bearings 16 44 

Gaskets 254 1,280 

Wheel Lock 75 ; j 
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Converting From 1-2-3 to Cornerstone 

You can convert spreadsheet files to a new Cornerstone file, 
or to one you've already defined. Your 1-2-3 files may 
contain database or numerical spreadsheet information. 
Before you convert information, you should decide whether 
to convert to a new file, or to define a Cornerstone file first. 
This decision will depend upon the type of information in 
your spreadsheet files. 


Converting Database Information From 1-2-3 

If you've been using 1-2-3 for database management, your 
1-2-3 files will probably be set up for easy conversion to 
Cornerstone. The field names in each column are equivalent 
to attributes in Cornerstone files. A row corresponds to one 
record. 


If you convert your database 1-2-3 files to a new 
Cornerstone file, the field names in your 1-2-3 file will 
become the new attributes in the Cornerstone file. If you 
want to take advantage of the more detailed data types 
available in Cornerstone, you can edit the conversion form. 
You can define your 1-2-3 data for any of the Cornerstone 
data types, except enumerated values. If you want your new 
Cornerstone records to have enumerated data types, do not 
try to convert your 1-2-3 data to a new file. In such a case, 
you will want to first define your Cornerstone file, and then 
convert your 1-2-3 data to this existing file. 


To convert data to a new file, follow the sample conversion in 
the next section. If you have database information, you will 
not need to reformat the data before doing a conversion. 


Converting From 1-2-3 to a New File 
To follow along with these examples you may want to create 
a sample spreadsheet file that looks like the screen below. 




















' Jan Feb. Mar 

2 AER aS ake SNe 
3 Ball Bearings 16 4 78 

4 Gasket 254 115 178 

5 Wheel Lock 75 56 78 

6 

7 

8 


Cornerstone organizes information into records. The 
spreadsheet data is in a matrix format. In this sample, each 
cell has two referents—the product name, and the month. 
You must reformat the cells so that each row will have 
column names. These column names will become attribute 
names for Cornerstone records. Instead of the original 
format, you will need three columns of data: Product, Date, 
and Quantity. (Use the Copy command to reformat the 
data. ) The screen below shows the new layout. 
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Ball Bearings 16 xt) 78 
Gaskot 254 115 178 
Wheel Lock 75 56 78 
Product > Date” Quantity § 

‘Ball Bearings Jan. ; 16 

Gasket Jan. 254 
‘Wheeltock = Jan 15” 

‘Ball Bearings - Fab. 34! 

‘Gosker Feb 115 
‘Wheellock Fab. ED 

‘Ball Bearings ‘Mar, 78 

‘Gasket Mar 178 
Wheellock = = Mars 


Save the new layout (A9...C19), including headers, in a new 
file called PRODUCTS. If you have a two-diskette system, 
copy this file from your spreadsheet data diskette to the 
Cornerstone Sales diskette (or the Client Tracking diskette) 
copy. If you have a hard-disk system, save the file ona 
diskette in drive A. 


Enter Cornerstone with the Sales database. From Initial 
mode, enter 

UTILITIES CONVERT 

CUSTOMIZE 


Cornerstone displays the customization form for Convert 
mode. The customization form lets you specify how you 
want the conversion to proceed. This form is shown below. 





¥ 
b 
Sw 
ke 
ae] 
"4 





Enter values into the form. 
EDIT Begin at record number INTEGER OMS 


Number of errors before abort 0 
Number of errors displayed: 0 
Create error log file?’ Yes 
Fix errors during conversion?, No 
Use defined constraints? No 
Restore database if aborted? Yes 
Log nonprintable ASCII?: Yes 
Error attribute name 

Begin at record number: (i) 


Attribute names in record number 1 
Hex record delimiter string ODOA 
Hex field delimiter string: 2C 


File Previous mode. Customize Files viewed 


This form is used (among other things) to specify what 
information to convert as record data. Cornerstone’s default 
is to assume that the first row of the spreadsheet will be the 
first record in the database, the second row will be the 
second record, and so on. In our example, the first two rows 
of the spreadsheet file contain header information (column 
names, and a row of dashes). Since you don’t want this 
header information as data in your new Cornerstone file, you 
need to edit the entry Begin at record number. Change “1” 
to “3.” Now Cornerstone will skip over the first two rows 
and start at the third one when the conversion begins. 


[x] When you edit Begin at record number this change will be in effect for all 
subsequent conversions. If you are doing other conversions, you may 
want to return the default setting to “1.” 
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% 

Press (DONE) when you've finished editing the customization | 
| form. You are now ready to begin the conversion. Enter the  — 

iu 

command: 
CONVERT FROM 1-2-3 

\: PRODUCTS.WKS NEW_FILE PRODUCTS ‘—" 
| The new Cornerstone file will be called Products. Now Se 
another form appears, describing how Cornerstone will ) == 


convert the spreadsheet data. This form is shown below. 


Enter values into the form 


EDIT Ist Attribute.Attribute Name STRING OVS 


| 
| NEW-FILE conversion form \ = 
Atrribute Namo Atuibute Type Include in transfer? a 


Product Yes 


Date STRING Yes 
Quantity INTEGER Yes EF 








File Previous mode Convert Files viewed b 


| The first column displays the proposed attribute names, the 

_ second column their data types, and the third column tells iS — 
| Cornerstone whether to include the particular spreadsheet = 
fields in the conversion. 








e 
J 
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| 
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You can edit this form as you would any other Cornerstone 
form. In this case Cornerstone assigned the column headers 
as the new attribute names, so few changes are necessary. 
The attribute names (Product, Date, Quantity) in this form 
are taken from the first sample record of the 1-2-3 file. 


| 





» Carefully check the values assigned for “Attribute Type,” “eal 
as these are not easily changed after the conversion. = 
Convert mode goes by appearances only. For example, 
some fields that should be strings, such as zip code, may 
look like numbers. Make any necessary changes. 


You can choose which attributes you want to include in your 
conversion. Since we want all the attributes included in the 
transfer, the form is correct as it stands. 


When you are done editing the form, press (DONE). Enter 
CONTINUE to begin the conversion. 


After the conversion has finished, Cornerstone shows the 
number of records processed and the number of errors that 
occurred, if any. If any errors occurred, you can examine 
them by exiting Cornerstone and typing the DOS file 
PRODUCTS.ERR. See the sections Customization, and 
Conversion Errors, for more information. 





54 The Convert Utility 


ee 








Press (DONE) to return to Initial mode. You can then view 


| your new Cornerstone file, shown below. 





Select a command from the menu. Use arrow keys or type the command 


Es UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT BUDDIES 
VIEW products 9 Records NOT SORTED 
Product Date Peer ne sae Oh ote Quantity 
1) Ball Bearings Jan 16 
Gasket Jan. 254 
Whee! Lock Jan, 15 
Ball Bearings Feb. 34 
Gasket Feb. 115 
Whee! Lock Feb 56 
Ball Bearings Mar 78 
Gasket Mar, 178 
Wheel Lock Mar 78 


——— 
File: products Previous mode. Initial Files viewed: 1 


Converting From 1-2-3 to an Existing 
Cornerstone File 

You can also import data from 1-2-3 to an existing 
Cornerstone file. 


If you have been using the spreadsheet as a database, you 
can define a Cornerstone file with attributes that 
correspond to the field names in your 1-2-3 file. Define your 
Cornerstone file in advance, and use the EXISTING-FILE 
option on the command line. 
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On the other hand, you may begin using Cornerstone, and 
then find you want to transfer spreadsheet information to 
use with your Cornerstone file. For example, you may have 
sales order data for this year in Cornerstone that you want 
to compare with historical summary data from your 
spreadsheet. 





In this case, the problem is that a row of summary data 

in a spreadsheet is not equivalent to a single record in 
Cornerstone. Each Cornerstone record corresponds to 

an individual order, while a 1-2-3 row contains a summary 

of all orders for a product. You can, however, set up a 
Cornerstone file so that you can convert summary 
spreadsheet data, and use it with your new Cornerstone 
data. If this situation applies to you, read on through the next 
example. Otherwise, you may want to skip over it. 


We have created two Cornerstone files, a product entry file, 
called Product Orders, containing a subfile Line Items, anda 
second file, Sales Tracking. Line Items and Sales Tracking 
are related. 


Sales Tracking will hold both the converted data from the 
spreadsheet and derived data from the Line Items subfile. 
(Remember that data cannot be converted to a subfile. ) 


At the moment there are no records in Sales Tracking. First 
you will transfer data from 1-2-3 into the file, and then you 
will see how new data entered in Line Items will appear in 
Sales Tracking to produce new summary information. 
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In the following examples, we will use a 1-2-3 spreadsheet 


file called PRODUCTS.WKS. This file contains sales ores 
| summary information—units sold in each month for three 
| products. You may want to enter this sample file into your —— 
spreadsheet, so you can follow the examples closely. If you '. 


worked through the examples in the previous section, you 
can use the same spreadsheet file. The figure below shows _ 
= 
| 


the original spreadsheet file. 








Ball Bearings yt: 34 78 nm — 
Gesket 254 11 178 am 


Wheel Lock 75 56 78 


} 
2 
K} 
4 
5 
6 
7 
8 


| ‘lo prepare this data for conversion to Cornerstone, reformat = 
the data in your spreadsheet. Instead of the matrix 

spreadsheet format, you will need three columns of data— bk == 
Product Name, Months, and Quantity, as displayed below. = 














Ball Bearings 16 34 78 
Gasket 254 115 178 
Wheel Lock 75 56 78 
Product Date Quantity 
pee so BG Sant ne COURS Bucs 
; e a ~ dan =3 Jae a 
ock dan, rr 
Feb. 
‘Feb. ¥-, seek 5 
“Wheel Lock Li EOD cro ecuase 
“Ball Beanngs — “Mar, tha Bechers 
Gasket Man ree us 
| Wheel Locks = Mar clea 


To convert data into an existing file you don’t need the 
headers, since the attributes will be provided by the 
Cornerstone file. Save only the reformatted data 
(A11...C19) as a new spreadsheet file, called PRODUCTS. 


If you have a two-diskette system, copy the 
PRODUCTSWKS file from your spreadsheet data diskette 
to your Cornerstone Sales diskette (or Client Tracking 
diskette) copy. Hard-disk users should save the spreadsheet 
file on a diskette in drive A. 


You are now ready to begin the conversion process. Enter 
Cornerstone with the Sales database, and enter the 
command: 


UTILITIES CONVERT 
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If you did the previous example, importing 1-2-3 to a new file, you will 


~~ need to reset the c hange made in the customization form In the ) 
customization form, change Begin at record number to “1.” When you ve — 
finished editing the form, you will be in Convert mode, | 
Next, enter the conversion command: .= 
jm 
CONVERT FROM 1-2-3 


A: PRODUCTS.WKS EXISTING-FILE SALES_ TRACKING 


| Now a conversion form appears on your screen. This form 
allows you to match the data in your spreadsheet file to the 
appropriate attributes in the Cornerstone Sales Tracking | aa 


file. This form is shown below. } 
— 
} Enter values into the form, =, 


EDIT 4th Attribute.Input Field Number INTEGER OVS 
EXISTING-FILE conversion form. 


Attnbute name Input field number Type Bas 
me aS a a a ee er Ee 





PRODUCT_NAME , STRING 
MONTHS 2 STRING 
ST_LINK STRING oe 
QUANTITY INTEGER F l 
DOLLARS NUMBER = 
i — 
= 


SS 
File Previous mode: Convert Filos viewed. 


The first column contains attribute names from the Sales 
Tracking file. The last column lists their data types. The "b 
middle column is used to match the data items from the 
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spreadsheet file with attributes in the Sales Tracking file. 
There can be more attributes than data items in the 
spreadsheet file. Look over the form to make sure each 
attribute has the correct type. 


If everything is correct, press (DONE). Enter CONTINUE to 
start the conversion. You can halt the conversion at any time 
by pressing (CANCEL). 


After the conversion has finished, Cornerstone displays the 
number of records processed and the number of errors, if 
any. (If you have errors, see the sections Customization, and 
Conversion Errors. ) 


You can now look at your new data by viewing the Sales 
Tracking file. (Use the COLUMN command, and specify three 
attributes, PRODUCT, DATE, and QUANTITY.) The result is 
displayed in the screen below. 


Select a command from the menu, Use arrow keys or type the command. 





= UPDATE SELECT VIEW COLUMN DETAILED 
USE SAVE REPORT SORT PRINT ALL-DONE 
VIEW Sales_tracking 9 Records NOT SORTED 
PRODUCT NAME MONTHS QUANTITY 
)} Ball Bearings Jan. 16 
Gasket Jan 254 
Wheel Lock Jan 75 
Ball Bearings Feb. 34 
Gasket Feb. 15 
Wheel Lock Feb 56 
Ball Bearings Mar. 78 
Gasket Mar 178 
Wheel Lock Mar 78 


nnn ELE 
File: Sales__tracking Previous made. Initial Files viewed 1 


ah) 
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DIF Files 





Now that your spreadsheet data has been safely transferred, 
| you can heave a sigh of relief and think to the future: to 

_ entering new data in your Sales Tracking file. From here on, 
you can enter order data into the Line Items in the Product 

| Orders file. This new data will then be summarized in the 
Sales Tracking file, along with your historical spreadsheet 

| data. 


In our earlier example we transferred the data for January, 
February, and March from the spreadsheet. The sample 
Product Orders file also contains line items data for April, 
May, and June. You can automatically see summary data for 
these months in Sales Tracking by entering the following 


| 


| commands: 


VIEW SALES_TRACKING 
UPDATE NEW_RECORD 
When you enter a product name and month in the data entry 


form, Cornerstone computes the other values (Quantity and 
Dollars) from Line Items, as shown below. 





PRODUCT NAME: Gasket 
MONTHS: Apr 
QUANTITY: 48 
DOLLARS: 24.00 


[X] If you're interested in seeing how these files are defined, enter Define 
mode and print the file definitions. 


A wide variety of software programs, including many 
graphics programs and spreadsheets, use the DIF file 
format. 


If you are converting to or froma spreadsheet such as 
Visicalc, you should read the sections above on converting to 
or from 1-2-3 files. Remember to substitute pir for 1-2-3 on 


mA Fi 





f 
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ff 


qt qt 
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the command line. You may need to readjust the data types 
in the conversion form if you are converting to a new file. 


If you are using DIF for any other type of program, refer to 
the sections above about the MailMerge file format. Again, 
substitute DIF for MAILMERGE on the command lines. If you 
want to follow along with the examples, create a sample DIF 
file, and substitute this filename on the command lines. 


The SDF (Standard Data Format) file format is an ASCII 
fixed-field-width format that is used by a wide variety of 
programs, especially minicomputer and mainframe database 
management systems. If you want to import data from a 
larger computer, such as a corporate mainframe, this will 
likely be the appropriate file format to use. 


Exporting an SDF File 
Exporting from Cornerstone to an SDF file is basically the 
same as exporting to any other file format. You specify the 
destination (SDF) file name, the source (Cornerstone) file, 
the format to use, and (optionally) selection criteria to use. 
The commands below display a sample export to SDF: 
UTILITIES CONVERT 
CONVERT TO SDF A: CUSTLIST. SDF CUSTOMER NAME 


This would convert the Name format of the Customer file to 
an SDF file called CUSTLIST. SDF. 


For a detailed description of file conversion from 
Cornerstone, refer to the section above on the MailMerge 
file format. 
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SDF Files 
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Exporting to SDF to has one unusual feature. Once you 
enter the commands shown above, Cornerstone presents 
you with a form to edit. This form is shown below. 


ni 


iM 


Enter values into the form, 


EDIT Ist Attribute.Field Length 





TO-SDF conversion form 


| Attnbute Name Freld Length | = 





aah 








NAME bs 

STREET. 35 dione 

CITY 7 ) = ill 

STATE 5 om, 

ZIP 10 } 

1! 

| — 
| ted! 
} 
| — 
| " 
| ia 
File CUSTOMER Previous mode Convert Files viewed — ] 

é ie 
The form lists each attribute included in the saved format ] 
you specified on the command line, and the field lengths for i 
each attribute in that format. This length information is is 


required for SDF, since that is how fields are delimited 
(there are no field separators). The total of all the lengths is 
must be acceptable for the software that will eventually use =, 
this SDF file. You can change the lengths, if necessary. * 





When you press (DONE), Cornerstone starts converting the ean 

records of the source file. You can halt the conversion at any y 
time by pressing (CANCEL). ; 1. 

a | 

wy 

= 
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After the conversion is complete, the number of records 
processed, and the number of errors, if any, are displayed in | 
the data area. 


If any errors have occurred, you can see them by typing the 
DOS error file. The error file has the extension .ERR. 
Refer to the sections Customization, and Conversion 
Errors, for more information on errors. 


Importing an SDF File 

Importing an SDF file to Cornerstone is basically the same 

as importing from any of the other file formats. The section 
on conversion from MailMerge gives the general file import 
case. The one difference when importing an SDF file is that 
you must tell Cornerstone where each field begins. For this 
reason, there is one additional conversion form that you use 
to set the field lengths. This form is shown below. 


Enter values into the form. 
EDIT ist Attribute.Field Breaks 


FROM-SDOF conversion form 
Place a caret character (,) underneath the first character of each field. 
123456789012345678901234567890 1234567890 123456789012345678901234567890 
9557 1000 1 20. Transmission Case Rear Bushing Rem 


J- 
A -- Ae oe = FT SS SE SS 


SUNTS YES 





12345678901 234567890 12345678901 234567890 12345678901 2345678901234567890 
over and Installer 


eS 


File: Previous mode. Convert Files viewed 
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This form displays a sample record from an SDF file. The 


| data is displayed underneath a rule. Below the data is a line 


of dashes. The first dash has been replaced by a caret (*), 


| indicating the start of the first field. You need to place a 

| similar mark below the start of the other fields, by placing a 
_ caret under the first character of each field. (Use the arrow 
| keys to move to the desired place on the line. ) 





When editing the form, there are a couple of things to look 


| for. Since the form displays one record, it may or may not be 


representative of other records in the file. Other records 
may contain fields that are empty in this record. The 
starting point for each field may not coincide with the start 
of the data in the displayed record. This is particularly a 
problem with numbers, which may be right-justified within 
their field. 


You may wonder: How do I figure out the correct starting 
point for each field? There are two ways to do this. If you 
have a corresponding data entry form for your SDF file, it 
may be marked with column numbers for each field. Or you 
can look at a printout from this file and find the largest 
values. 


The sample form above shows an edited form with carets 
added for each field. Notice that the carets for the number 
fields do not always line up with the data values. 


| Once you've completed the FROM-SDF conversion form, 


press (DONE). Cornerstone then presents you with the 
normal import form for conversion to a new file or an 
existing file, as appropriate. The section on conversion from 
MailMerge gives a detailed description of the file import 
process. 
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The TEXT file format is a standard ASCII file format. This 
is used by a wide variety of programs, including most word- 
processing programs. The TEXT file format has variable 
length fields. 


If you want to export toa TEXT file, use the PRINT DISK 
command in Cornerstone. (See chapter 7, “Printing,” in 
Owner's Handbook I.) 


Importing a TEXT File 
To import a TEXT file, you must first tell Cornerstone what 
constitutes a field and a record. In your TEXT (ASCII) file 
you can use whatever characters you want to delimit fields 
and records. When you are ready to import this file into 
Cornerstone, you need to edit the Convert mode 
customization form to specify these delimiters. To do this, 
enter the commands 

UTILITIES CONVERT 

CUSTOMIZE 


Then edit the appropriate lines in this form. See the next 
section, Customization, for more information. 


When you finish editing the customization form, you are 
ready to begin the conversion. The above section on 
converting from the MailMerge file format gives a detailed 
description of the conversion process. 


You can tailor the operation of Convert mode in a number of 
different ways. To do this, issue the CUSTOMIZE command in 
Convert mode. 


Cornerstone presents you with a customization form to edit, 
shown below. Any changes you make remain in effect until 
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TEXT Files 


Customization 
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| you change them again, even between Cornerstone 


| sessions. 


| Most of the customization features allow you to control the 
| way Cornerstone deals with the errors that occur during a 
| conversion. You can combine different settings for the 


‘ = 1 M . al y; - r 
| options to fit the requirements of your conversion; several of 
them are specifically designed to operate in concert. The 


values in the form below show the default options. 


Number of errors before abort: 0 
Number of errors displayed: 0 
Create error log file?: Yes 

| Fix errors during conversion?: No 
Use defined constraints?: No 
Restore database if aborted?: Yes 
Log nonprintable ASCII?: Yes 
Error attribute name 

Begin at record number: 1 
Attribute names in record number: 1 
Hex record delimiter string: ODOA 
Hex field delimiter string: 2C 





Each option is described individually in the following 
sections. 


Number of errors before abort 

Fillin the number of errors you wish to allow before the 
conversion is automatically aborted. Every time that number 
of errors occurs, you will be asked whether to abort the 
conversion or to continue. A value of zero turns this feature 
off (the conversion is never stopped). This feature is useful 
as a check that you haven’t done something drastically 
wrong. [t prevents you from wasting hours converting a 
large file, only to discover that all the records have the same 
mistake. 
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Number of errors displayed 

Fill in the number of errors you wish to see displayed in the 
data area as they are encountered during the conversion. 
This allows you to get a quick look at the type of error(s) 
occurring. With a value of zero, the number of errors will 
only appear in the data area at the end of the conversion. 


Create error log file? 

This feature creates a DOS file containing the records in 
which errors occurred during a particular conversion. This 
file is created only if errors do occur, and only if “Yes” is 
filled in for this option. Answer “No” to this question if you 
don’t want Cornerstone to create an error file. (We dis- 
courage you from doing this.) You can examine the contents 
of the error log file with the TYPE command in DOS. 


Every time you import or export data, the file name (and 
drive) you type in on the command line for the foreign file is 
used for the error file, regardless of the extension you type 
in. The error file always has the extension “. ERR”. 
Consequently, the error file is overwritten every time 
errors occur in a conversion using that file name. (A 
conversion to CONTACTS.SDF and a conversion from 
CONTACTS. DIF both generate an error file named 
CONTACTS. ERR.) In such a case Cornerstone stops after 
you enter the command line, tells you that an error file with 
that name already exists, and asks if you want to replace the 
old error file. If you want to keep the old file, you must exit 
Cornerstone, and use DOS to rename the old file. 
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Fix errors during conversion? 

The default setting is “No,” which means that Cornerstone 
does not stop the conversion process, even if there are 
errors. The defaults in this form are set up for experienced 


| users. If you are a novice user, you may want to answer 








“Yes” to fix errors during conversion. If you answer “Yes 


| here, Cornerstone will stop in its tracks every time it 


encounters an error, and give you a chance to edit the 
offending record. (This is true for importing records only, 
not exporting. ) The cursor will be on the field where the 


| error occurred. After you correct the value (or clear it), you 


can edit any of the fields previously filled in as well. The 
conversion continues when you leave Edit mode. 


If you enter the command CANCEL FORM in Edit mode (which 
erases all the values in the form) Cornerstone asks you 


| whether or not you wish to abort the conversion. 


Use defined constraints? 

Answer “Yes” to check imported data against the constraints 
you have defined for attributes in an existing Cornerstone 
destination file. If you answer “Yes,” the conversion process 
will go much slower. Examples of constraints include 
minimum and maximum values, mandatory values, and 
unique values. Values that do not meet defined constraints 
are not Imported, but are instead logged in the error file. 


Restore database if aborted? 

This feature lets you start from scratch if you abort a 
conversion for some reason. If you reply “Yes” here. 
Cornerstone restores the destination file to its original state 
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(before the conversion began). Any records converted up to 
that point will be deleted. 


Log nonprintable ASCII? 

Foreign files occasionally include characters of the ASCII 
code that are not visible. These characters are not 
meaningful to Cornerstone, so Cornerstone replaces them 
with spaces. 


If you fillin “Yes” for this option, occurrences of such 
characters are logged in the error file. If you fill in “No” 
here, nonprintable characters are still replaced with blanks, 
but they are not noted in the error file, and you will not 
know of their occurrence. 


Error attribute name 

Filling in a name here will cause a new attribute with that 
name to be defined in the Cornerstone destination file, and 
to appear in each imported record. Attributes for which 
conversion errors have occurred are not filled in; using the 
error attribute lets you see their names and pre-conversion 
values without having to check the error log file. You can 
then easily update the record to correct the errors. 


The error attribute is multi-valued, to allow for multiple 
errors, and is of type String. 


Begin at record number 

Used to specify which record of the source file Cornerstone 
should consider the first record for conversion purposes. 
Cornerstone ignores any preceding records. The default is 
set to 1, which means that Cornerstone begins the 
conversion with the first record of the file. 


Skipping the first several records is useful when they contain 
information that you don’t want entered as data in your file. 
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_ Cornerstone to determine the number of fields and, if you 
| are using the NEW-FILE option, the data type of each field. If 
| the sample record doesn't contain data, the values in the 











For example, the first few records may Cc tain field labels, 
blank lines, or lines of dashes. This is particularly likely 
when you are importing a file set up as a spreadsheet, 1n 
which the first record is often a row containing labels for the 
columns beneath it. 


The record specified in this field will be used by 


NEW-FILE conversion form will be misleading. 


Attribute names in record number 

Use this option with the previous one, Begin at record 
number. The default is set to 1, so that the first record is 
used in the conversion form. If you know that a specific 
record contains the names or labels for the fields in the 
source file, enter the number of that record here. 
Cornerstone can then use these names for attributes in the 
NEW-FILE conversion form. 


This feature is not used when importing dBASE II or PFS 
files, since those formats contain field names elsewhere in 
the file. 


Hex record delimiter string 

This option and the following one are to be used together, 
when importing with the TEXT option, to specify delimiters 
for records and fields. 


The TEXT option requires that you tell Convert mode what 
separation markers to look for in order to distinguish records 
from one another. You must enter the hexadecimal ASCII 
code for the delimiter used in your source file. The default 
setting is ODOA, a carriage-return line-feed as the record bh 
delimiter. See the HEX/ASCII Chart in chapter 13 to find = 





the correct digits to enter. 
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Hex field delimiter string 
This option and the previous one are to be used together, 
when importing with the TEXT option. 


You must enter the hexadecimal ASCII code for the field 


delimiter used in your source file. The default is set for 2C, a 


comma as field delimiter. The field delimiter can be more 
than one character long. See the HEX/ASCII Chart in 
chapter 13 to find the correct digits to enter. 


There are a variety of errors you can inadvertently make 
during a conversion. Most of the simpler ones are caught, 
and can then be corrected with the help of the error 
message and associated Help information. Several more 
complex ones are explained below. 


Using Customization to Fight Errors 

The following methods for detecting or correcting errors 
are available as options to Convert mode’s CUSTOMIZE 
command; they are described in the previous section. 


O Check the error log file to see what errors occurred 


© Seta number of errors before abort to catch errors 


before they pile up 


as they occur 





O Fix errors during conversion, with Edit mode 


© Restore your database if aborted to start from 
scratch if you cancel the conversion 

OQ Log nonprintable ASCII to detect nonprintable 
characters in your source file 

O Create an error attribute to show the errors in the 
imported record itself 





1 Set anumber of errors displayed to see the errors 
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Error: Incorrect Data Type 





This error occurs when importing a foreign file. During the 
conversion process, Convert mode assigns data types to data 


| items in the source file. These type assignments are made 
| by the NEW-FILE conversion form (if you used the NEW-FILE 
| option), or on the basis of your original file definitions (if you 


used the EXISTING-FILE option). If an item contains invalid 


| a nterie A 
characters (for instance, if it is supposed to be an integer 


and it contains letters), an error is signalled. Cornerstone 
displays a message in the error window, and the record is 
logged in the error file. However, no error is signalled if the 
data appears to Cornerstone to be of the correct data type. 
Keep in mind that anything written in printable characters 
looks like string data; any value can be converted as a string 
without an error being signalled. Therefore, significant 
errors can go undetected until you look at the imported file. 
Zip codes are an example of this problem. They are analyzed 
as integers and passed through the conversion without 
error. But when they are displayed, all leading zeros have 
been lost. 


Incorrect data type is the hardest error to fix, since the type 
of an attribute in a Cornerstone file cannot easily be 
changed once data has been entered for it. If the 
Cornerstone destination file contains only the records you 
converted, then you can delete them all and try the 
conversion again with the correct data type. If the 
Cornerstone file already contained records you want to 
keep, then you might have to delete just the records you 
don’t want. 
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Errors: Truncation and Spillover 

These errors are encountered when converting SDF files. If 
the field lengths you set for the SDF destination file (using 
the TO-SDF form) are too short to accommodate some of the 
exported Cornerstone values, then those values will be 
clipped short, or truncated. A notice of this error (which is 
the only error you are ever likely to have when exporting) is 
displayed in the error window and in the error log file. 
Unless you can repair the SDF destination file, it’s easiest to 
do the conversion again, using longer field widths. 


Spillover is the reverse of truncation, and occurs when 
importing an SDF file. If you make a mistake editing the 
FROM-SDF form, and set a field break marker in the wrong 
spot, then characters from one field may “spill” into an 
adjacent one. This has two unfortunate consequences. The 
first is that every record in the file might need to be repaired 
to get the correct values entered for the fields in which the 
error occurred. The second is that characters of the wrong 
kind can trigger a data type error (for instance, if letters 
spill over into a field assigned for numbers). However, this 
data type error is the only way Cornerstone has of knowing 
that a spillover error has taken place! To fix the damage, it’s 
best to do the conversion over. 


An outline description of what Cornerstone actually does Processing a 
when it processes a file for conversion may help you better File 

understand the whole operation, and thus help you plan a 

more informed strategy. 


Exporting 

When you export a Cornerstone file to a foreign file format 
(this is the simpler of the two directions of conversion), 
Convert mode uses the information about the Cornerstone 
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file to make a copy of all the data init, reformatted according 
to the requirements of the foreign file type that you have 


selected. 


Importing 

When you import a foreign source file into Cornerstone, 
Convert mode begins by examining a representative record; 
usually this is the first one in the file. In order to determine 
where the first record ends and the next one begins, 
Cornerstone searches for a certain character or other 
indicator that is used as the record delimiter for that file 
format. Then, Cornerstone counts the number of fle/ds in 
the record, based on the rules the foreign format has about 
how fields are marked. In some cases a certain character 
serves as a field delimiter, which separates adjacent fields. In 
spreadsheet files, rows are treated as records, and columns 
are regarded as fields. If you are using the NEW-FILE option, 
the number of fields in the foreign file will be used to define 
the same number of attributes in the Cornerstone 
destination file. 


If the foreign format you have selected includes names for its 
fields, then these names are used for the new Cornerstone 
attributes. If the foreign format doesn’t include field names, 
then Cornerstone shows you the actual values found in the 
representative record, as an aid to your naming the new 
attributes. 


After counting the fields, Convert mode analyzes the data 
item found in each, and decides which of Cornerstone’s data 
types should be assigned to each new attribute. The results 
of this decision are shown to you (in the NEW-FILE form), so 
that you can correct any mistakes Cornerstone made. 
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The actual conversion of a source file proceeds 
automatically, record by record, until every one 1s 
converted, or until you decide to halt the conversion. 
Nothing in a source file is altered by a conversion; the 
destination file is merely a copy containing the original data 
in anew form. 





You may need to know what data looks like before and after it | Analyzing Data 
is converted. 


Analyzing Imported Data 

When importing to new files, Convert mode's initial analysis 
of data items found in foreign files is not infallible, as 
decisions are often made based on the surface appearance of 
the data. 


Since Cornerstone data values fall into seven different types 
(String, Number, Integer, Date, Time, Enumerated, and 
Boolean), data being converted from foreign formats must 
be assigned to one of them. If the foreign format (dBASE II, 
1-2-3) includes in its files information about different data 
types, then this is used by Convert mode to convert values 
of those types into their Cornerstone equivalents. If this is 
not the case (MailMerge, TEXT, SDF, PFS), then each 
value in the source file’s sample record is scrutinized, anda 
decision about its type is made. 


Analyzing Exported Data 

Analyzing the data in a Cornerstone file to be exported is 
easy, since very detailed information on every attribute in 
your database is contained right within Cornerstone. 


An export conversion preserves any data types that may be 
recognized by a given foreign file format. This only has real 
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significance for DIF and 1-2-3 files; SDF, MailMerge, and 

| TEXT formats make no real distinction between types of 
data—every value is essentially just a group of characters 
that can be processed later in various ways by the software 
that uses that format. 


_ Conversion of Cornerstone Data Types 

_ There are some rules of thumb about how Cornerstone 

_ treats certain kinds of data during conversion. Let's look at 
| each Cornerstone data type (which you can learn more 

| about in chapter 9, “Planning Your Database,” in Owner's 
Handbook I). 


String. Imported data containing alphabetic 
characters is treated as a Cornerstone string value. In 
addition to ordinary strings like names, addresses, and 
notes, this includes the labels found in spreadsheets 
that identify the contents of its rows and columns. 

| String values look the same when exported as they do 
inside Cornerstone. 





Number. Imported groups of digits with a decimal 
point somewhere among them are analyzed as 
Cornerstone numbers. If a certain number of decimal 
places are shown, then Convert mode usually uses that 
style when displaying the number. Otherwise, a default 
style of two post-decimal digits is used. Most of the 
foreign file formats recognized by Convert mode do not 
internally store numbers in the same Way as 
Cornerstone; numbers in such files are written simply 
as a String of digits, such as 1234567890.12345, or 
(ere 2.7e249. *> Consequently, Convert mode is limited 
to the degree of precision shown in the source file. <~ 
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1-2-3 files use the same internal storage method as 
Cornerstone. Very large and very small numbers 
(ones requiring scientific notation) can be imported 
and exported to 1-2-3 with no loss of accuracy. Convert 
mode is also able to provide an equivalent for 1-2-3's 
numeric display formats. dBASE II files contain some 
special formatting information, and Convert mode 
attempts to duplicate these special formats. 


Integer. Groups of digits with no decimal point among 
them are analyzed as Cornerstone integers. They are 
imported and exported like numbers in all other 
respects. 


Date. Data written in any of the display styles used 
within Cornerstone for dates are analyzed as dates by 
Convert mode. They are imported and exported in 
Cornerstone’s default display style: 1/1/85. Exception: 
dates are exported to 1-2-3 files using 1-2-3's default 
display format for dates: 01-Jan-85. 


Time. Data written in the display styles used within 
Cornerstone for times are analyzed as times by 
Convert mode. They are imported and exported in 
Cornerstone’s default display style: 1:01 PM. 
Exception: in 1-2-3 files, times are written simply as 
strings of digits (e.g., 130100). 
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Enumerated. None of the file formats recognized by 
Convert mode provide true enumerated values; the 
value imported for a Cornerstone enumerated 
attribute is simply a string. Enumerated attributes 
cannot be defined with the NEW-FILE form, since 
Convert could not determine the set of allowed values. 
In such cases, define a Cornerstone file and use the 
EXISTING-FILE option. Cornerstone enumerated values 
are exported as strings. 


Boolean. Of the formats recognized by Convert 

mode, only DIF and dBASE II provide real Boolean 
values; these are imported and exported as the strings 
“TRUE” and “FALSE.” For other formats, the strings 
“y,” “n,” “yes,” “no,” “t,” “f,” “true,” and “false” are 
analyzed as Cornerstone Boolean values. Cornerstone 
Boolean values are exported as the strings “Yes” and 
“No.” 

If you import data into an existing Cornerstone file, any 
attributes in it that are z/ti-valued will receive data only for 
| their first value. Only the first value of a multi-valued 

| Cornerstone attribute is exported. 


| 
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The Backup Utility 


You should back up your database files regularly to insure Introduction 
them against damage or loss. You can make backups directly 

from Cornerstone using the Backup utility. In addition, 

backing up has the added benefit of reclaiming the space left 

by deleted records and attributes, and of removing damaged 

records from a file. 


Backup mode lets you back up all your database files, just 
one file, or just a subset of a file. Your backup includes not 
only the data, but also any selection criteria and formats you 
have saved. 
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You can back up files to diskettes or to a directory on a hard 
disk. If you want to back up onto diskettes, be sure you have 
enough blank formatted diskettes on hand. To find out if your 
files will fit on one diskette, exit Cornerstone and enter the 
DIR command at the DOS prompt. This command displays 
the contents of your directory and the size of each file in 
bytes. If the total size of the files you want to back up 
approaches the total capacity of a diskette, you will need 
more than one diskette for your backup. 
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The RESTORE command restores backup files to the 
database. Depending on how you used the BACKUP 
command, you may restore every file on the backup diskette 
to your database (which replaces everything in the 
database), or restore a single file. When you restore just a 
single file, you have the option to replace the database file 
with the backup file, or to append the backup file to a 
database file. 


w 


Backup mode also provides the REORGANIZE command, 
which reorganizes your files to make the system run more 
efficiently. 
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Backing Up From Initial mode, enter the command UTILITIES 
Your Database BACKUP/RESTORE. Cornerstone now enters Backup mode. 
Files 


Next, if you want to back up all the files in your database, 
enter 


BACKUP ALL-FILES 
| If you want to back up a single file, enter 
BACKUP SINGLE-FILE 
| and select a file you want to back up from the menu. 


| Cornerstone displays the name of the drive or directory on 

which it will create the backup. 
© Ifthe drive or directory is correct, enter EXECUTE to 

start the backup. (On a two-diskette system, you must 

back up to drive B.) 

© If you want to back up to some other drive or 
directory, choose the DRIVE option then enter a valid 
drive or directory name. When you back up to a 
directory or subdirectory (either on a hard disk or on a 
diskette), you must specify the path to the backup 
directory (for example DRIVE \\;CORNER\. BACKUP). 
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x» Don’t backup to a diskette or directory that contains 
backup files that you still want to save, because they will be 
overwritten by the new backup. == 
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Sorting a Backup File 

When you back up a single file, you can sort the file before 
backing it up. A sorted backup file is particularly useful when 
it is restored to the database: the resulting database file will 
remain sorted until you update it. he 
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‘To sort a backup file, select SoRT then select the attribute 
you want to sort by. Next, choose the order (ASCENDING or 
DESCENDING) in which to sort. At this point, you may press 
(ENTER), or specify additional attributes to sort by. 


If you change your mind and decide you don’t want to sort 
your backup file after all, enter the SORT command without 
an argument to cancel the sort you specified. 


Backing Up a Subset of a File 

The SELECT command lets you use selection criteria to back 
up only the records that meet the criteria. For example, you 
might want to archive records created before a certain date 
by backing with the SELECT option, and then deleting them 
from the database file. 


To back up a subset of a file, choose SELECT then choose 
selection criteria from the menu. (The menu lists all saved 
selection criteria for the file you are backing up. ) 
Cornerstone will then back up only the records that meet 
the selection criteria. 


If you change your mind, enter the SELECT command without 
an argument to cancel the selection. 


Backing Up to a Diskette 

After you enter the EXECUTE command, Cornerstone 
displays a message telling you to insert a backup diskette in 
the drive you specified, and to press any character to start 
the backup (or press (CANCEL) to cancel the backup). 


If your files do not fit on a single diskette, the backup 
procedure pauses, and Cornerstone prompts you to insert a 
second diskette in the specified drive. When the second 
diskette is in the drive, press any key to continue the 
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backup. The backup procedure pauses in this manner 
whenever a diskette is full. If you have to use more than one 
diskette, label the first diskette “1,” the second “2,” and so 
on, because you must repeat that order when you restore 
the backup files. 


When the backup is complete, Cornerstone returns to the 
| Backup mode menu. If you are using a two-diskette system, 
insert the Cornerstone system diskette in drive B before 
| you issue a command. 


[x] Cornerstone does not back up a record that has been damaged somehow. 
A damaged record will not interfere with the backup process, but when 
the backup is complete, Cornerstone informs you that not all the records 
were backed up. Since the faulty record may cause trouble later on, and 
there is no way to repair it, you should restore the backup file (which 
contains no faulty records) immediately to replace the file in your 
database. 
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Howto Restore | You can only restore what you have backed up. If you backed 
a Backup File up your database with the BACKUP ALL-FILES command, 
restore it with the RESTORE ALL-FILES command. Likewise, if 
you backed up a file with the BACKUP SINGLE-FILE command, 
restore it with the RESTORE SINGLE-FILE command. f 


ij 


When you restore using the RESTORE ALL-FILES command, 
all your database files are deleted and are replaced by your 





backup files. When you restore a single file, you have a k- 
choice: you may replace the file in your database with the 

backup file, or you may append the backup file to the Ute 
corresponding database file. ee 


From Initial mode, enter the command UTILITIES 


BACKUP/RESTORE. k jaa 
. a] 

0 If you backed up your files all at once, restore them 
with the RESTORE ALL-FILES command. = 




















© If you want to restore a single backup file, such as 
Customer, and have it replace the corresponding 
database file, enter 
RESTORE SINGLE-FILE CUSTOMER REPLACE 


O If you want to restore a single backup file, such as 
Customer, and append it to the corresponding database 
file, enter 


RESTORE SINGLE-FILE CUSTOMER APPEND 


At this point, Cornerstone displays the name of the drive (or 
directory) that it will restore from. 


O Ifthe drive is correct, enter EXECUTE. 

© If you want to restore from some other drive or 
directory, choose DRIVE, then enter the name of the 
drive or directory. After this, enter the EXECUTE 
command. 


Restoring from Diskettes 

After you enter the EXECUTE command, insert the first 
backup diskette, and press any key. The system then 
displays the date and time the backup file was created and 
asks you whether it’s the one you want to restore. If so, 
answer “Yes” to start restoring. 


If your backup files reside on more than one diskette, the 
system will pause when everything from the first diskette 
has been restored and prompt you to insert the next 
diskette. You must insert the diskettes in the same order 
they were used when you backed up your files. The system 
will pause in this manner whenever it has restored 
everything from one diskette and other backup diskettes 
remain. 
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When the system has finished restoring, Cornerstone 
prompts you to return the Cornerstone sy stem diskette to 
| drive B, and then displays the Backup mode menu. 


Restoring from a Hard Disk 

When you restore from a directory on a hard disk, you need 
| only confirm that you want to RESTORE the backup files 
| listed in the data area. When the process is complete, the 
| system displays the Backup mode menu. 


Reorganizing If you have deleted many records from your database, if you 
Your Database have defined new attributes for a file after entering data into 
the file, or if you have deleted attributes, you can make your 
database more efficient with the REORGANIZE command. 
This command reclaims the unused disk space taken up by 
deleted records and attributes, removes damaged records, 
and restructures your files to be more storage-efficient. 





You can reorganize one file, or all files, in a database. 
Cornerstone copies the reorganized file to another diskette 
or directory, and restores the reorganized file to the 
database, replacing the original file(s). 


("> | «> When the REORGANIZE command restructures a file to 
which attributes were added or deleted after data was 
entered, it may render the file incompatible with any backup 
files that were made before the reorganization. If you have 
any records in backup files that you still want to use, restore 
them to your database before issuing the REORGANIZE 
command, = 


To reorganize a file, in Initial mode enter the UTILITIES 
BACKUP/RESTORE command. 
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O ‘To reorganize all your files, enter REORGANIZE 
ALL-FILES. 





0 ‘To reorganize a single file, enter REORGANIZE 
SINGLE-FILE, followed by the file name 


Cornerstone then displays the name of the drive (or 
directory) where it will reorganize your files. 


O Ifthe drive is correct, enter EXECUTE. 





© If you want to reorganize in some other drive or 
directory, choose the option DRIVE and enter a drive or 
directory name. Then enter EXECUTE. 


As with BACKUP and RESTORE, if you are reorganizing to 
more than one diskette, Cornerstone will prompt you when 
it requires the next diskette. 


In addition to their primary use as a means to back up your 
database, the BACKUP and RESTORE commands have other 
valuable applications. 


Putting Data Off-Line 


You may use the BACKUP command to remove data you 
don’t use often, but which you prefer not to delete. You may 
decide, for example, that you no longer need the records 
on orders from 1983. To do this, you would first create 

and save selection criteria to select orders for 1983 (call it 
83_Orders), then enter Backup mode and issue the 
command 


BACKUP SINGLE-FILE ORDER 
Next, you would issue the command 


SELECT 83_ORDERS 
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_and finally enter EXECUTE to back up the file. To delete the 
unwanted records, return to View mode with the file 


VIEW ORDER 


| and use the same selection criteria to select the working 
set: 


USE SELECTION-CRITERIA 83_ ORDERS 


Next, enter Update mode with all records, 


UPDATE ALL 
and issue the command 
DELETE ALL-UPDATE-RECORDS 


Finally, back up and restore the file you just deleted the 
records from to recover the space taken up by the deleted 
records. You can restore these records (as long as you 
haven't changed the database structure in the meantime) by 
issuing the command 


RESTORE SINGLE-FILE APPEND 


Sorting a File 

Although you may use the SORT command in View mode to 
sort a set of records, the records are not actually sorted in 
the file, but only in the display or report. In Backup mode, 
you can issue the Sor’ command to sort your backup file, 
then issue the RESTORE REPLACE command. The records in 
the resulting database file will be sorted. Although the 
records will look sorted to you after this procedure, the 
system won't know they are sorted; when you issue the 
SUBTOTAL command, for example, the system will still ask 
you to sort the records. 
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“Multi-User” Application 

You can use the BACKUP and RESTORE SINGLE-FILE APPEND 
commands to take data from separate Cornerstone sources 
and merge them into one central Cornerstone database. For 
example, you may use one Cornerstone at a central office, 
and have several other Cornerstone users at field offices. At 
the end of every week, each field office selects the past 
week's records and backs them up on a diskette which it 
sends to the central office. At the central office, you use the 
RESTORE APPEND command on each of the field office’s 
backup files to add their data to the central database. 


Using Backup mode in this way may call for new strategies, 
because © no constraints are enforced when you append 
data to a file. <2 For example, Cornerstone would allow 
several sales offices to forward orders with duplicate order 
numbers to the central office, even if order numbers had 
been defined to be unique. One solution in this case would 
be to rely on an attribute derived (using the STRING 
function) from a combination of the location of field site and 
the order number. The order numbers would be duplicated, 
but each order could be uniquely identified by the derived 
attribute: for example, Rochester-7, Fort Worth-7, 
Sunnyvale-7, and so on. 
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The Recompute 
Utility 


The UTILITIES RECOMPUTE command in Initial mode lets you | Introduction 
recompute values for particular attributes in a file. When 

you use RECOMPUTE, Cornerstone sequences through the 

records in your file and recomputes the value for each 

attribute using the attribute's initial value expression. You 

can use selection criteria with the RECOMPUTE command to 

recompute values only for selected records in the file. 


Below are come common situations where the RECOMPUTE When to Use 
command is useful. RECOMPUTE 


To Initialize New Attributes 

When you add a new attribute to a file that already contains 
data, the records in the file won’t have values for the new 
attribute until you enter them. You can use RECOMPUTE to 
provide values for all the records in the file, provided you 
can express the values you want the records to have as an 
initial value expression. 


Suppose, for example, you have a file called Clients, to 
which you add an attribute called Date to Contact, which you 
want to contain the date you should next contact your client. 
Let's further assume you have a subrecord attribute in this 
file, Contact History, which contains a history of previous 
contacts, including the dates of previous contacts. To supply 
values for the new attribute, Date to Contact, you could give 
this attribute an initial value expression such as 


ADD_INTERVAL— DATE(LAST(Contact— History. Date), 30) 


and then issue the command 
UTILITIES RECOMPUTE CLIENT 
OTHER-ATTRIBUTES DATE_TO_CONTACT 
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After this command completes, all the records in the Chent 
file will have a value for Date to Contact. The value will be 
_ 30 days following the date of the last contact. 


_ To Make a Derived Attribute Primitive 

| You may decide, in order to increase the speed of your 
system, to change some of your derived attributes to 

| primitive ones with initial value expressions. (The next 
chapter, “Efficiency With Cornerstone,” provides an 
example of this, and discusses in greater detail reasons for 
making a derived attribute primitive.) Whenever you change 
the type of an attribute from Derived to a primitive type 
(such as Number), you should then use the RECOMPUTE 
command to compute values for the new primitive attribute. 


To Update Maintained Attributes 
You can use RECOMPUTE periodically to update (recompute) 
the values for »aintained attributes. Maintained attributes 
are simply attributes you've marked because you plan to 
recompute them from time to time, using the RECOMPUTE 
command. By making attributes maintained, you don’t have 
to explicitly select them every time you use RECOMPUTE. 
For example, to update the maintained attributes in your 
Customer file, you could simply issue the command 
UTILITIES RECOMPUTE CUSTOMER 
MAINTAINED-ATTRIBUTES 


For more information about maintained attributes, see the 
next chapter, “Efficiency With Cornerstone.” 


To Perform Bulk Updates 

You can use the RECOMPUTE command with or without 
selection criteria to update a group of records in your file. 
Suppose, using the Sample Database as an example, that the 
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price of a slide hammer just went up from $20.00 to $22.00, 
and you want to adjust the price in all outstanding orders. 
Since List Price in the Order file is computed from Price in 
the Part file using an initial value expression, you can use 
RECOMPUTE. You can use selection criteria with RECOMPUTE 
to recompute only values for orders taken since a particular 
date that also contain a request for one or more slide 
hammers. 


To Change the Type of an Attribute 
You can use the RECOMPUTE command to “change” the type 
of an attribute that already has data. 


Suppose, for example, you have an attribute called Secunty 
Code in a Companies file that is Enumerated, and you want 
to change it to be a String, because you want to use a cross- 
file range constraint for Security Code instead of an 
enumerated attribute. (Chapter 9, “Planning your 
Database,” in Owner's Handbook I, discusses range 
constraints and enumerated attributes in more depth.) The 
procedure outlined below would accomplish this task. 


O Define anew attribute, called, say, String Security 
Code. Define it to be of type String. 

0 Give String Security Code the initial value expression: 
STRING(Security_Code). This converts the 
Enumerated Security Code to a String. 


O Issue the command: 
UTILITIES RECOMPUTE COMPANIES 
OTHER-ATTRIBUTES STRING_SECURITY_CODE 
c Now you can delete the original attribute, Security 
Code, and rename String Security Code to Security 
Code. 
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How to Use 
RECOMPUTE 





You have to be careful if the attribute whose type you want 
to change (in our case, the original Security Code) 
participates in a relationship or if it is referenced in any 
derivation or initial value expressions elsewhere in your 
database. If either of these situations arise, you must first 
remove the relationship(s) and derivation/initial value 
expression(s) before deleting the attribute. (Cornerstone 
will warn you if you attempt to delete such an attribute 
without first doing so.) Then you must define a new 
relationship (and/or derivation/initial value expressions) 
using the new attribute. 


You won't go wrong if you understand that you are not really 
changing the type of the original attribute. Instead, you 
create a new attribute, and then use the RECOMPUTE 
command to copy the values from the original one. 


To use the RECOMPUTE command, select UTILITIES 
RECOMPUTE from Initial mode. Next, select the file you want 
to recompute values for. You now have two options: 


O MAINTAINED-ATTRIBUTES lets you recompute values 
for all the attributes you've defined as maintained. 
(You don’t have to remember which these are. ) 


QO OTHER-ATTRIBUTES lets you select specific attributes 
to recompute. You can select as many attributes as you 
like, and they need not be maintained. Cornerstone 
displays a menu of attributes for you to choose from. 
The menu contains only attributes that have an initial 
value expression. When you've selected as many 
attributes as you wish to recompute, press (ENTER). 


Once you've issued the UTILITIES RECOMPUTE command 
(using either MAINTAINED-ATTRIBUTES or OTHER- 
ATTRIBUTES), if the file contains saved selection criteria, 
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Cornerstone next displays a menu of selection criteria and 
prompts you to select criteria to use. If you choose selection 
criteria, Cornerstone recomputes values only for records 
meeting those criteria. If you simply press (ENTER) (without 
selecting a menu option), Cornerstone will recompute 
values for all the records in the file (1.e., 1t will not use any 
selection criteria). 


One frequent reason to use selection criteria with the 
RECOMPUTE command is to recompute values only for 
records that don’t already have a value for a particular 
attribute. To do this, first create selection criteria that select 
records not having a value for the attribute (type EMPTY in 
the selection form), then RECOMPUTE using these selection 
criteria. 


You can use the RECOMPUTE command while editing a record 
in Edit mode under Update mode to recompute the value for 
a particular field in a single record. (You can simply press 
Ctrl-U to issue the RECOMPUTE command in Edit mode. ) 


When you issue this command in a particular field, 
Cornerstone computes the initial value and inserts it in the 
current field. 
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Once your database suits your needs—when your database Introduction 
matches the way you want to input data, update records, and 
report on the information you have entered—then you can 
begin to consider how to make it operate more efficiently. 
The primary techniques for improving performance are 

(1) to use indexes, (2) to use primitive attributes with initial 
values instead of derived attributes, and (3) to use the VIEW 
ONLY-RELATED-RECORDS command to produce multi-file 
reports. 
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Indexing reduces the time required to perform a selection. Indexing 
Normally, when you select records froma file, Cornerstone | Attributes 
searches the entire file sequentially to find records that 

satisfy the selection criteria. This can be slow for large files. 

Indexes speed up the selection process by allowing the 

system to access records with particular attribute values 

directly, in the same way that the index in a book allows you 

“al to access information on a particular subject directly, rather 

=. than having to search through the entire book. 


Ww 


Indexes speed up selection when the selection involves 
exact matches, prefix matches, and ranges. Cornerstone 
uses the index whenever it can when performing these 
kinds of selections. Cornerstone uses combinations of 
indexes to speed up selections based on more than one 
attribute. 


% 


Indexes speed up not only selection, but also finding related 
records, checking uniqueness constraints, sorting, and 
checking cross-file range constraints. Give an attribute an 
index if 
© You want to use the attribute to define a relationship. If 
you give each of the attributes defining a relationship 
between a pair of files an index, Cornerstone can then 
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access information in the related file more quickly. 

You define the attribute to have unique values. With an 
index, Cornerstone can quickly determine whether a 
particular value already appears in the file or not. 


The value of an attribute in another file is constrained 
to be one of the values of this attribute. For example, if 
Order. Name is constrained to take a value of 
Customer.Name, then the Name attribute of the 
Customer file should be indexed. 


Ann a & 






© You plan to use the attribute frequently to select 
records. 

© You plan to use the attribute frequently to sort the file. 
Indexing an attribute significantly speeds up sorting 
when you sort an entire file on the attribute. 


You will find that these cases frequently overlap. For 
example, the Name attribute in the Customer file in the 
Sample Database is used to define a relationship, has unique 
values, and is used to constrain Name in the Order file. 





Indexing is not without cost. In particular, indexes must be 
updated every time you add or delete a record, or whenever 
you change the value of an indexed attribute. This takes 
time. The more indexed attributes a file has, the longer it 
can take to update a record in the file. 
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Indexes also take up disk space. Each index requires 
approximately NVALS«(VLEN +5) + (NRECS:3) bytes, 
where NVALS is the number of different values the attribute 
takes on, VLEN is the average length of each value, and 
NRECS is the number of records in the file. The more 
records a file has, the more disk space is required for its 
indexes. 
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Although derived attributes are extremely useful, always 
providing information that is accurate and up-to-date, they 
suffer from one drawback: it takes time to compute their 
values. To reflect the most recently entered data, 
Cornerstone always computes the values for derived 
attributes whenever they're printed or displayed. This may 
slow things down, especially when the derivation expression 
is complicated and when it references attributes in related 
files. 


Because their values continually change, derived attributes 
cannot be indexed. For this reason, it’s generally not a good 
idea to use a derived attribute to define a relationship. This 
is especially important in situations where selection speed is 
critical. For example, you can define a relationship using a 
derived attribute, but accessing data using the relationship 
will take some time, particularly if the related file contains 
many records. 


Instead of using a derived attribute, you can use a primitive 
attribute with an initial value expression. This solution 
works especially well if the values for the attribute do not 
change, or rarely change, once the record is created. You 
can use the RECOMPUTE command when you want to update 
the attribute (see the section below, Initial Values and 
RECOMPUTE). 


While these considerations are useful to have in mind when 
you are planning your database, you needn't be too 
concerned about making the correct decision. «<> You can 
always make a derived attribute primitive and vice versa, 
even after you have entered data into your files. = 
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Let’s consider an example from the Sample Database. Three 
of the attributes in the Customer file are derived: 


wii 


Attribute Derivation 





| Total Purchases © SUM(ORDER.TOTAL_AFTER_DISCOUNT) 








Total Units SUM(ORDER. TOTAL_ QTY) 





Number Orders © COUNT(ORDER) 
Because they are derived, the values for these attributes 
always reflect all orders that have been entered in the Order 
‘file. Their values are always correct. But every time you 
view or print a customer record containing, say, Total 
Purchases, Cornerstone must first locate all the related 
orders and then add the totals for all these orders. Since 
Total After Discount in the Order file is itself derived, 
Cornerstone must further sum the Piece for all the Line 
Items in each related order. If the number of orders from 
each customer is large enough, it may take some time to 
display reports containing 7otal Purchases. 





Initial Values and RECOMPUTE 

Cornerstone provides an alternate way to handle the kind of 
situation just described: you can use a primitive attribute 
with an initial value expression instead of a derived 
attribute. The only drawback is that, once a record is 
created, Cornerstone does not automatically update the 
value of the attribute when other attributes affecting it 
change. 
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The RECOMPUTE command provides a way to update the 
values. The RECOMPUTE command tells Cornerstone to 
recompute the values of one or more attributes—but first, 
you must 








O Make the attributes primitive 






© Supply each attribute with an initial value expression 






In our example, you would first redefine Total Purchases to 
be a Number instead of Derived (you would do this in Define 
wi mode). Cornerstone automatically copies the derivation 
expression to the initial value field whenever you change an 
attribute from derived to primitive, so you don’t have to re- 
= type the expression unless you want to alter it. 


















Total Purchases is now a primitive attribute; however, none 

a of the records in the Customer file yet has a value for Total 
Purchases. To compute values for the existing records, you 
must go to Initial mode and issue the command 


a UTILITIES RECOMPUTE CUSTOMER 
OTHER-ATTRIBUTES TOTAL_ PURCHASES 


ol Cornerstone sequences through the Customer file and 
' computes the value of 7otal Purchases for each record. (The 
= exact syntax of the UTILITIES RECOMPUTE command is 
| described in more detail in chapter 4, “The Recompute 
Utility. ”) 


a If you now add a new order, the 7dtal Purchases for the 

related customer record will become inaccurate (this is the 
x advantage you sacrifice when you make a derived attribute 
a primitive); however, any time you wish to update the values 
for Total Purchases to include recent orders, you only have to 
=. issue the RECOMPUTE command again. 
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You can change Total Units and Number Orders in the same 
way. 


The table below summarizes some of the differences 
between derived attributes and primitive ones with initial 
value expressions. 





ADVANTAGES DISADVANTAGES 

Derived Value always reflects most Must be computed every 
current information. time it’s referenced. Can't be 
Requires no disk space. indexed. Access may be 


slow, especially if related 
file(s) must be accessed to 
compute the value. 


Primitive Need not be computed Jalue not automatically 

With (value 1s stored). Canhave updated; you must maintain 

Initial an index. Access is fast. it. Information can become 

Value out-of-date. Requires some 
disk space. 








When to Make a Derived Attribute Primitive 

In several common situations, making a derived attribute 
primitive can speed up your database. While the 
circumstances are different for each, the common basic 
principle is: you gain speed, but your records may not 


always reflect the most up-to-date information. Make a ‘a i" 
derived attribute primitive , 
: : : i 
© When a derived attribute defines a relationship. If a. 
you make the attribute primitive, you can then inderx it, ; a 
rid 


which will provide an even greater increase in 
performance. Because Cornerstone must access the 
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attributes defining a relationship every time it has to 
locate related records or evaluate an expression 
referencing information in related files, your database 
will run faster when the attributes defining a 
relationship are primitive and indexed, rather than 
derived. 


O When viewing derived information quickly is 
more important to you than having it always reflect the 
most recent information. The sacrifice in accuracy 1s 

al j lessened if the derived information changes 

i infrequently or at predictable intervals. For example, 

in a database containing softball statistics, you may 
wt wish to examine players’ batting averages frequently— 
but these change only whenever the results of a new 
7 game are entered. If the derived player statistics, such 
at as batting average, slugging percentage, and runners 
advanced, are defined as primitive attributes instead of 
derived, then you need only RECOMPUTE them every 





a time you enter the results of anew game (which might 
be only once a week). But any time one of your 
: at teammates asks, “What's my average?” you can give 
= him an immediate reply. 
O When it takes longer to display reports containing a 
a..! particular derived attribute than it does to display 
reports that don’t contain the attribute. 
at r= You can always experiment with an attribute by changing = 1 
at its data type from primitive with an initial value to Derived 
and back. <2 You can then decide which alternative 
et performs best. 
Maintained Attributes 
ae The RECOMPUTE command lets you choose specific 


attributes to recompute. Often you will want to recompute 
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Multi-File 
Selections 





the same group of attributes. In our example, if you make \ 
Total Purchases, Total Units, and Number Orders primitive, : 
you'll probably want to recompute all three together. 


| Cornerstone makes it easier to recompute several attributes 





by allowing you to call the attributes maintained. Then, 
when you use the RECOMPUTE command, you can select the 
MAINTAINED-ATTRIBUTES option. Cornerstone will compute 
values for all the maintained attributes. This way, you don't 
have to choose which attributes you want to recompute 
every time you issue the RECOMPUTE command. (The 
attributes are called maintained because you maintain their 
values using RECOMPUTE. This is in contrast to Derived 


_ attributes, whose values are automatically maintained by 


Cornerstone. ) 


You can make any primitive attribute maintained simply by 
answering “Yes” to the question Maintained? in the 
attribute definition form. 


Another characteristic you can set for primitive attributes 
you plan to maintain is Changeable? Ordinarily, primitive 
attributes can be edited in Update mode, but if you are using 
a primitive attribute as if it were derived, you may want to 
prevent yourself or anyone else from changing the value 
accidentally in Update mode. To do this, simply answer “No” 
to the question Changeable? in the attribute definition form 
in Define mode. 


It is sometimes useful to select information in one file based 
on information in another file—for example, you may wish 
to see all the orders that are from customers in Boston. In 
such situations, there are two ways to produce the report. 
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Q Select the appropriate records in one file, then view 
the related records in the target file. In the example 
above, this means: select customers whose city is 
Boston, and then use the VIEW command to examine 
the related records in the Order file. 





Select the appropriate records based on an attribute 
that is derived from information in the related file. In 
the example above, this means selecting based on the 
City attribute in the Order file, which is derived from 
the Customer file. 


0 


Using the view command is often significantly faster than 
selecting on a derived attribute. In the example above, if the 
City attribute in the Customer file were indexed, then the 
first approach would require finding the customers in 
Boston (a quick operation) and then viewing their related 
orders. The second approach (selecting on the derived 
attribute City in the Order file), requires that each record in 
the Order file be searched, and for each record, computing 
the value of the City attribute, and, finally, checking 
whether this value is Boston (overall a slower procedure). 


Indexing and Selection Other — 
You can select on any attribute ina file, but selection is Strategies for 
usually faster if the attribute is indexed, for the following Efficiency 


types of selection: exact match, prefix match, and range 
selection. The performance gained by indexing is most 
significant for large files. Indexes are not used for wild card 
matches (except the prefix match) or negated criteria (NOT 
followed by some criterion). 
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Indexing and Sorting 

The system uses an index when it sorts the entire file ona 
single indexed attribute. Indexes are not used when sorting 
less than the entire file (for example, after a selection), or 
when sorting on more than one attribute. 


Processing and Display 

During a selection, only enough records to fill the screen are 
actually examined. (This is why the View mode status line 
sometimes contains a pair of numbers indicating a range for 
the number of records in the working set, instead of the 
exact number.) As you scroll the display, more records are 
examined. Some operations, such as sorting, require the 
entire working set to be examined, and thus may take some 
time, because the entire file must be searched (to complete 
the selection) before the sort can begin. 


Sorted Reports and the View Mode Default Format 
Cornerstone records are stored in the order in which they 
are created. They are not stored in sorted order, so that any 
time you wish to view a file in sorted order, it will take 
additional time. (You can use the Backup utility to sort a file, 
and then restore it in sorted order.) Therefore, sort a file 
only when necessary. In particular, consider carefully before 
saving a sorted default View mode format (that is, a format 
named View). This will always slow down viewing that file. If 
you wish to “unsort” a saved format, you can USE it, SELECT 
ALL (which unsorts), and then SAVE it away. 


Numbers and Relationships 

You may experience a degradation of performance when 
working with a file that has a relationship defined on a 
Number attribute. This is because of rounding errors that 
must be corrected. The most common example where you 
might use a number in a relationship occurs when you want 
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to relate information based on some sort of numeric code or 
key. In such cases, you should define the code to be an 
Integer (rather than a Number). This will avoid the rounding 
problems associated with numbers having a fractional part, 
and it is unlikely that you need to treat the code as a real 
number. In fact, unless you plan to perform arithmetic 
calculations using the code, you could just as well make it a 
String. 


la a 


To summarize: don’t define a relationship using a Number 
attribute if you can avoid doing so. 
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Constraints 

Imposing constraints, particularly unique value and cross-file 
range constraints, can slow the system down when you add a 
new record in Update mode. Whenever you enter a new 
value for an attribute that is constrained to have unique 
values, Cornerstone must check all the other records in the 
file to ensure that the value you entered is not already used. 
This can take a while, especially if the file is large. The 
same sort of thing applies to attributes whose values are 
restricted to those of an attribute in another file: 
Cornerstone must examine the records in the other file 
whenever you enter a value for the constrained attribute. 
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You can improve the situation by making the appropriate 
attributes indexed. (For a cross-file range constraint, index 
the constraining attribute; for unique values, the constrained 
attribute). You can also simply remove the constraint. And, 
if you don’t need all the records in your files, you can archive 
some of them. (See chapter 3, “The Backup Utility.”) 
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Constraints can also slow down the system when you use 
the Convert or Recompute utilities. If you plan to convert a 
large amount of data, or recompute values for a large 


\ 


\ | 


112 Efficiency With Cornerstone 


number of records, it may be worthwhile to first remove one 
or more constraints. Of course, if you do, Cornerstone will 
no longer enforce them. 


Efficient Formats 


_ Formats in Cornerstone need not include every attribute 





defined in the file. You should design your formats to contain 
only those attributes you are interested in. View mode 
report formats need only contain the attributes relevant to 


| the particular report. Selection formats need only contain 


fields for attributes likely to be selected on. Update formats 
need only contain attributes required for data entry. For 
update formats in particular, you should leave out 
unnecessary derived attributes when you design the form. 
Not only will this make the form simpler and hence easier to 
read, but it will also speed data entry, because the derived 
attributes you omit need not be computed as you enter data. 


Additional Hardware 

Adding more memory to your machine will speed up many 
system operations. Cornerstone uses all available memory 
when running. 


Using a hard disk will decrease the time it takes to access 
information in your database, thereby speeding up most 
system operations, The performance gained by using a hard 
disk is most significant for large databases. 
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Entering 
Information Into 
Forms 
This chapter describes what you can enter in Cornerstone Introduction 
forms, including 
Q Various ways to enter data for each data type 
© How to write selection expressions, derivation 
expressions, initial value expressions, and range 
constraint expressions 
O Explanations of Cornerstone functions 
This section lists the ways Cornerstone lets you enter Data Entry 


String, Number, Integer, Boolean, Enumerated, Date, and 
Time values. 


String 

You can enter a value of type String by just typing in the 
characters. You can use any character in a String except 
control characters. 


In the following cases, some further restrictions apply. 


© When you create or alter a print device in Print mode, 
or edit the customization form in Convert mode, some 
String fields accept only the characters 0, 1, 2, 3, 4, 5, 
6, 7, 8, 9, A, B, C, D, E, and F for specifying 
hexadecimal digits. 


O A String constant must have quotes around it if it is part 
of a derivation expression or initial value expression. 


Attribute name: MR_NAME 
Derivation: STRING(Mr. ", FIRST_NAME, LAST_NAME) 


Cornerstone places certain additional restrictions on the 
String values you enter as file and attribute names. Since 
Cornerstone will notify you if you try using an invalid name 
for a file or attribute, you need not be too concerned with 
these restrictions. 
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] ¥ y ac ge 29 
File and attribute names may be as long as 32 


characters. 


| The following characters may not appear within names 


of files and attributes. 


LL 














( (left parenthesis) 
) (right parenthesis) 
+ (plus sign) 





= (hyphen, minus sign) 





(asterisk, multiplication sign) 




















(slash) 
s (caret) 
(period) 
, (comma) 
(space) 


(quotation mark) 





A file or attribute name cannot begin with a digit (0, 1, 
2, 3, 4, 5, 6, 7, 8, and 9), but you can use digits within 
file and attribute names. 


You can’t use the following function names as names of 
files or attributes. 


NOW 
TODAY 
UNIQUE_ID 


(ARR 


_ 
n* 





AAR 


r 


AS 


| s if 
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© A file cannot have the same name as another file, 
another subfile, or an attribute within the same file. 


O An attribute cannot have the same name as a file, a 
subfile, or another attribute within the file. 


Although a String of numeric characters looks like a number, 
you cannot do calculations with it, and it will not necessarily 
sort like a number. If you want numeric values of type String 
to sort like numbers, the values must all have the same 
number of characters. You may have to enter leading zeros. 
The columns below are sorted numeric characters of type 


String. 
1 O01 
14 003 
007 
42 014 
55 042 
7 055 
999 999 


A sort of String values begins looking at the first (left-most) 
position, so any String value beginning in a “1,” for example, 
will sort before any value beginning in a “2.” Thus, the value 
14 appears before the value 3 in the column at left. With 
leading zeros, however, the values appear in their proper 
numerical order when sorted (column at right). 


If you are entering a value for an attribute that has a range 
constraint (that is, the value of the attribute 1s limited to 
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those values entered for an attribute in another file), you 
need enter only enough of the value to differentiate it from 
the other possible values. When you press (ENTER), the full 
value will be displayed. 


Number 

You can enter a value of type Number by typing digits, 
followed by a decimal point (if appropriate), then more 
digits. Cornerstone permits you to enter and display values 
of type Number in several formats: 


0 


As an integer, suchas 1, 2, 3, 4, 5, -3, -44, 55, 65355 
O With a decimal point, such as 3.1416, 2.51, .99 
With a dollar sign, such as $99.95, $1.00, $100, $5, $0 


O With commas, such as 1,000; 1,000,000. 00; 
$23,000.00. However, you may not enter a Number 
with commas as a constant in a derivation expression. 





O 


O 


In scientific notation, such as 2.99e5 (for 299000), 

7.18e-4 (for .000718) 

O With amiunus sign to mark values less than zero, such 
as -l, -16.5, -3e12 

O With parentheses (instead of a minus sign) to mark 

values less than zero, such as (1000), (99.95), 

(1.30e57). You may not, however, enter a Number in 

parentheses as a constant in a derivation expression; 

use a minus sign instead. 





When you press (ENTER) Cornerstone displays a value the 
way you defined the attribute. If you define an attribute to 
display a dollar sign, for example, you need not enter a dollar 
sign with the value. 
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Integer 
All the formats allowed for values of type Number are valid 


for values of type Integer, except that values of type Integer 
may not have a decimal point. 


Boolean 
Enter a value of type Boolean as 


TRUE, FALSE, YES, NO, Y, N, T, or F 








: = You may also enter any unique prefix, for example, 
— TR, TRU, FA, FAL, FALS, YE 
7a Enumerated 


Enter an Enumerated value using enough characters to 
differentiate it from the other possible values for that 
attribute; when you press (ENTER), the entire value will fill 
in. To see all the possible values, press the (OPTIONS) key. 


In a derivation expression or initial value expression, you 
must type enough characters to differentiate it from other 
possible values, and put quotation marks around the 
characters. 





ld 


Enumerated values sort based on the order in which they 
were entered in the Enumerated values field when the 
attribute was defined; they do not sort alphabetically by 
their values. 


Enumerated values that look like numbers don't act like 
numbers. They can’t be used in arithmetic calculations. 


ey 3 i 1 


If you define an Enumerated attribute to take an initial 
value, the initial value expression must result in one of the 
aie Enumerated values, otherwise an initial value will not be 
“3 filled in when a record is created. 
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Date | 
Cornerstone allows you to enter and display values of type ——o 


Date in many formats. 


| To enter the month, you have the option of using 
J Full text January, May, December) 
O Abbreviated text (Ja, Fe, Feb) 
' © Anumber (1 for January, 5 for May, 12 for December) 
| To enter the year, you have the option of using 
© Four digits (1985, 2001) 
O ‘Two digits (85 for 1985, 57 for 1957, 03 for 1903) 
You can use these sequences of date elements. 
O MONTH DAY YEAR 
O DAY MONTH YEAR 
DAY MONTH (for a date in the current year) 
MONTH. DAY (for a date in the current year) 
| © MONTH YEAR (for the first of the month) 


O MONTH (for the first of the specified month for this 
year) 


© YEAR (for January 1 of that year) 


0 


O 


You can separate date elements with 


O A hyphen between elements 


Oo 


A slash between elements 


0 


A space between elements 


O 


A comma between day and year in the MONTH DAY 
YEAR order 


O 


A comma between month and year in the DAY 
MONTH YEAR order 
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O Acomma between month and year in the MONTH 
YEAR order, or 


© No separators, in the format MMDDYY 


Cornerstone interprets ambiguous dates that have three 
elements as MONTH DAY YEAR (for example, 1/8/84 is 
January 8, 1984, not August 1, 1984). Dates that have two 
elements are interpreted as MONTH DAY in the current 
year (11 30 is November 30, 1985, not November 1, 1930.) 


Any Date format may be preceded by the name of the day of 
the week, followed by a comma. The name of the day can be 
in full or abbreviated form: 


Thursday, August 1, 1985 
WED, JAN 30 85 
Fri, 17-5-1985 


You may also enter a date that falls within the present, 
previous, or following calendar week, month, quarter or 
year by entering LAST, THIS, or NEXT with a day of the 
week, the name of a month, or the words WEEK, MONTH, 
QUARTER, or YEAR. 


LAST with a day of the week will display a date in the 
previous calendar week; with the name of a month, it will 
display the date for the first of that month in the previous 
year; with the word WEEK, it will display the date of Sunday 
in the previous week; with the word MONTH, it will display 
the date for the first of the previous month; with the word 
QUARTER, it will display the first date in the previous 
quarter; with the word YEAR, it will display the date 
January 1 for the previous year. 


THIS displays dates for the current week, month, quarter, 
or year. You can omit THIS. Cornerstone interprets 
MONDAY as THIS MONDAY. 
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NEXT displays dates for the following week, month, 


quarter, or year. 





| Example: today’s date is Wednesday, July 17, 1985. 











LAST MONI JAY 


Monday, July 8, 1985 





LAST WEEK _ 


Sunday, July 7 1985 





LAST MONTH ; 


Saturday, June 1, 1985 





LAST FEBRUARY 


Wednesday, February 1, 1984 





LAST QUARTER 


Monday, April 1, 1985 





| LAST YEAR 


Sunday, January 1, 1984 





THIS SATURDAY : 


Saturday, July 20, 1985 
































THIS WEEK Sunday, July 14, 1985 
THIS MONTH Monday, July 1, 1985 
THIS APRIL Monday, April 1, 1985 
THIS QUARTER Monday, July 1, 1985 
THIS YEAR ‘Tuesday, January 1, 1985 
NEXT FRIDAY Friday, July 26, 1985 
NEXT WEEK Sunday, July 21, 1985 
NEXT MONTH Thursday, August 1, 1985 





NEXT DECEMBER 
NEXT QUARTER 


Monday, December 1, 1986 








Tuesday, October 1, 1985 





NEXT YEAR 


Wednesday, January 1, 1986 
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You may abbreviate the words LAST, THIS, NEXT, the 
days of the week, the names of the months, and the words 
QUARTER, YEAR, WEEK, and MONTH. However, be 
sure the characters in your abbreviation differentiate it from 
other possibilities (for example, MON could be MONTH or 
MONDAY). 





Other valid entries for values of type Date are 


YESTERDAY 
TODAY 
TOMORROW 


These may be abbreviated to YES, TOD, and TOM. 


fou can enter a Date value quickly (if an option like TODAY 
isn’t appropriate) by typing one or two digits for the number 
of the month, and two digits each for the date and the year, 
all without punctuation. 


81485 
120384 


When you press (ENTER), the date will appear in the format 


l ; you specified when you defined the attribute. 

E a Time 

za You can enter a value of type Time in one of these formats 
_= O 24-hour time, such as 09:00, 23:59:59, 17:00 

a 4 AM and PM times, suchas 9:00 AM, 5PM, 

' 12:30:55 PM 

I at O With M for 12 noon, 1.e., 12:00 M, 12M 


f O Without colons, such as 0930, 153000, 11, 15 


eat 
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1 NOW 

0 NOON 

2 MIDNIGHT 
| Of course, the hours portion of a Time may be no greater 
than 23, the minutes and seconds portions no greater than 
| 59. 
In the AM/PM format, 12:00 M is twelve o'clock noon, and 
12:00 AM is twelve o'clock midnight (the end of the day). If 
you don’t specify AM or PM, Cornerstone interprets 12 (or 


12:00 or 1200) as twelve o’clock noon. 
Seconds are optional in any format. 


When you press (ENTER), the time will appear in the format 
you specified when you defined the attribute. 


Selection 


You enter selection expressions only in selection forms, 
Expressions 


which appear when you enter the SELECT BY-FORM command 
in View mode. You may enter more than one criterion ina 
field, more than one field in a form, and each set of selection 
criteria may contain more than one form. C hapter 5, 
“Selecting Records,” in Owner’s Handbook J tells you more 
about selection. 





CF fos Uppercase and lowercase letters are treated the same in 
selection expressions. = 


You can enter these kinds of selection expressions: 


Exact Match 

Enter exactly the value or values you want to match. You 
may use any valid entry format for the data type of the 
attribute you want to match. Cornerstone selects records 


(from the initial set) which contain that value in the specified 
attribute. 
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Wild Card 
This kind of selection is available for values of type String 
only. Cornerstone uses the asterisk (:*) to match any (or no) 
values. In the following, A and B represent any character or 
set of characters. 








Ax selects all values that begin in A 





AxB selects all values that begin in A and end in B 


AB» selects all values that begin in A and have a B 
anywhere following 





A selects all values that end in A 





*A*B selects all values that end in B and have an A 
anywhere preceding 


The fastest wild card selection is with a prefix match (those 
with a single trailing asterisk, like AB) for an indexed 
attribute. (Chapter 5, “Efficiency With Cornerstone,” gives 
more information on efficiency considerations. ) 
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fa P| 
Ranges | 
You can use ranges for values of type String, Number, Date, = =H 
and Time. 
| 
ee oF selects values greater than or equal iy) aa 
GE X eek \ 
oa : RX selects values greater than X f : 
GT X 
(eee selects values less than or equal to X i. 
LEX 
| BEFORE X 
Sh selects values less than X = 
Ay : | 
XEENZ. selects values between X and Z, 
including X and Z 





X...Z EXCLUSIVE selects values between X and Z, but 
not including X and Z 








Ranges for values of type Date may also be specified using 
the relative terms LAST, THIS, and NEXT with YEAR. 





) ee 

QUARTER, MONTH, WEEK or with specific months or bl 
days of the week like JANUARY and THURSDAY. If today’s | 

date is Wednesday, July 17, 1985, Cornerstone interprets f == 
\. 

= (As ) 
LAST YEAR as the re 01/01/84 ... 12/31/8 

e range 01/01/84 ... 12/31/84 i. a 

LAST JANUARY as the range 01/01/84... 01/31/84 he, 

LAST QUARTER __ as the range 04/01/85 ... 06/30/85  — 

SR a en eee } —- ~ 

LAST MONTH as the range 06/01/85 ... 06/30/85 ‘a 

LAST WEEK as the range 07/07/85 ... 07/13/85 , =] 








— = ——- 
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You can also specify a range for a financial quarter with 1Q, | 
2Q, 3Q, or 4Q. | 


When you enter a range using one of the relative date 
formats above, the range is stored as a constant. It does not 
change when the date changes. For example, if, on 
September 8, 1985, you enter LAST WEEK as a range 
expression, the range will be stored as: 

09/01/85 ... 09/07/85. 


Empty 
To select records with no value in the specified attribute, 
enter the word EMPTY. 


Non-Empty 
‘To select records with any value in the specified attribute, 
enter an asterisk (+) alone, or enter NOT EMPTY. 


Negation of a Criterion 
To negate a criterion, enter the word NOT before it. For 
example, 


NOT 9.95 
NOT AFTER TODAY 
NOT California 


NOTA... M (selects values that don’t begin 


with a letter from A to M) 
NOT ... 1000 (selects values greater than 1000) 
NOT JULY 1, 1948... 


NOT Cambridge 


(selects values before July 1, 1948) 
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Range 
Constraint 
Expressions 


Derivation and 
Initial Value 
Expressions 





Literal 

Cornerstone interprets NOT, GE, GT, LE, LT, “*’, *...; 
BEFORE, AFTER, EXCLUSIVE, EMPTY and ‘*\’ as 
special selection terms unless you type a backslash 
immediately before them. For example, 


SPOUSE’S NAME: Not Applicable 


selects records with a value other than “Applicable” for the 


| Spouse's Name attribute. To select records with the value 


“Not applicable” you must type a backslash before the word 
“not.” 


SPOUSE’S NAME: \.Not Applicable 


You enter range constraint expressions in the field Restrict 
values to file when you define an attribute. The expression 
takes the form 

file_name.attribute_name 


where file_name is the name of any file in the database 
(except the current file), and attribute_name is the name of 
one of its attributes (of the appropriate type). 


You only have to type enough of the file and attribute names 
to uniquely identify them. When you press (ENTER), 
Cornerstone fills in the rest of the name automatically. 


The kinds of entries you can make in derivation expressions 
and initial value expressions are identical. 
You enter derivation expressions when you 


QO Define a Derived attribute 


0 Issue the CALCULATE command to def ine anew 
derived attribute on the fly 





1 a 
7 

| 
ms 
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You enter an initial value expression 






© In the /nitial value field when you define an attribute 






QC When you use the INIT-VALUE command in Update 
mode. 






The result of a derivation expression or an initial value 
expression is always a single value. These expressions can 
take the form of mappings, constants, or function 
expressions. 







Mappings 

A mapping specifies an attribute from which to derive a 
value. The attribute can be in the current file, a parent file, 
a subfile, or a related file. A mapping expression for an 
attribute in the current file is simply the attribute name. 





















Uae of Otherwise, a mapping takes the form 
| file_name, attribute_name 
pane where file_name is the name of a related file, parent file, or 


subfile, and attribute_name is the name of an attribute in 
oa that file. Examples: 
f CITY 

CUSTOMER. NAME 


— ORDER. TOTAL_ PURCHASE 

= : LINE_ITEMS.QTY 

a A mapping can name a multi-valued attribute only if the 
f mapping is the argument to an aggregate function (see 
ae Function Expressions below). Otherwise, a mapping can 
- a name only a single-valued attribute. 


= When you type a file name or attribute name in a mapping, 
L al you need only type enough characters to uniquely identify 
pe the name. When you press (ENTER), Cornerstone will fill in 
—— | the rest of the name automatically. 
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Constants | f 
You can enter a constant as a derivation or initial value i) ae 
expression by just typing in the value, except p 
© Values of type String and Enumerated must be entered — 
with quotation marks around them. a 

O Values of type Date, Number, and Integer cannot be 


entered with commas. 


O Values of type Time should be entered in the 
HH:MM:SS format. 


Entering just a constant as a derivation expression may not be very 
useful, since you will not be able to change the derived value when 
editing a record. If you enter a constant as an mitial value instead, it will 
appear automatically when you create a record, but you can change it if 
you desire. If you really want the same value to appear in every record, 
enter it as constant text in the form in Format mode 


Function Expressions 

A function expression consists of a function followed by its 
argument(s). A function performs a calculation on a value or 
values, and returns a single value of a particular type. 
Depending on the function, the argument can be a mapping, 
a constant, an attribute name, a file name, an arithmetic 
expression, or another function expression. 





Cornerstone functions are categorized into six groups 
according to their arguments and result: aggregate, 
mathematical, date, time, financial, and string. 





| When you type a function name, you need only type enough 
characters to uniquely identify the function. Cornerstone 
will fillin the rest of the name of the function when you 
press (ENTER). 
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Aggregate Functions 
An aggregate function takes an attribute that represents a set 
of values as its argument and returns a single value. The 
argument to an aggregate function must be either 
QO amulti-valued attribute in the current file, related file, 
or subfile 


O a single-valued attribute in a related file or subfile 
The one exception is the function COUNT (see below). 


If the argument is a multi-valued attribute in the current file, 
the aggregate function returns a value for each record. If the 
argument is an attribute in a related file, the aggregate 
function returns a value based on the set of related records. 


Although several of the aggregate functions share names 
with the aggregate operators you use when you make a total 
or subtotal in View mode, they differ in their use. 
Remember, you set up totals and subtotals for a report by 
entering a command in View mode. You enter one of the 
following aggregate functions only when you are defining a 
derived attribute or writing an initial value expression. 
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Aggregate 3 
Functions ee 
AVG This function takes one argument, an attribute of type : 
Integer or Number. It returns the average value of the a 
attribute, which is the sum of the values for the attribute 
divided by the number of non-empty values. Result type: —_ 
Integer or Number. h 
Attribute name: AVERAGE_ SCORE 1 
Derivation: AVG (TESTS) od 
STUDENT NAME: White, S. 
TESTS: 98 
99 
97 
AVERAGE SCORE: 98 
COUNT This function takes one argument, either the name ofa 


related file or subfile, or a multi-valued attribute in the 
current file. It returns the number of related records, or the 
number of values in the multi-valued attribute. Result type: 
Integer. 


Attribute name: NUMBER_OF_LINES 
Derivation: COUNT (LINE_ITEMS) 





ORDER NO: 7 | 


CUSTOMER NAME: T Motors = 

7 
PARTNUMBER QTY _—LISTPRICE ~— PRICE.-—_—=ODESCRIPTION | 
J-1111 5 15.00 75,00 Spanner — 
J-0504 4 25.00 100.00 += Wheel Lock Pe 
NUMBER OF LINES: 2 | 


J 


— 








MAX 





MIN 
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This function takes one argument of type Number, Date, 
Time, or Integer. It returns the maximum value entered for 
the attribute (if a Number or Integer) or the latest value (if a 
Date or Time). Result type: same as argument. 


Attribute name: HIGH_ BUY 
Derivation: MAX (ORDER.TOTAL_ PURCHASE) 


ORDERNO:23 ORDERNO: 44 ORDER NO: 67 
NAME: T Motors = NAME: T Motors NAME: T Motors 


TOTAL — TOTAL TOTAL 


PURCHASE: 100.00 PURCHASE: 49.00 PURCHASE: 333.00 


NAME: T Motors 
HIGH BUY: 333.00 | 





This function takes one argument of type Number, Date, 
Time, or Integer. It returns the minimum value entered for 
the attribute (if a Number or Integer) or the earliest value (if 
a Date or Time). Result type: same as argument. 


Attribute name: EARLIEST_CALL 
Derivation: MIN (CALL.CALL_TIME) 


CALL NO: 233 CALL NO; 456 _ CALL NO: 789 
CLIENT: Adams CLIENT: Adams = CLIENT: Adams 
CALL DATE: 1-30 = CALL DATE: 11-12 = CALL DATE: 11-14 
CALL TIME: 9:30am = CALLTIME: 7:45am > =CALLTIME: 12m — 


CLIENT: Adams 
EARLIEST CALL: 7:45 am 
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This function takes one argument of type Number or 
Integer. It returns the standard deviation of the non-empty 
values for the attribute. Cornerstone calculates the value as 


SIGNAL LOSS: 3 





CABLE TESTED: B700 


TEST NO: 3 


CABLE TESTED: B700 
SIGNAL LOSS: .02 





STDEV 
the square root of the variance (see the VARIANCE 
function). Result type: Number. 
Attribute name: STANDARD_ DEVIATION 
Derivation: STDEV (TEST.SIGNAL_LOSS) 
TEST NO: 1 TEST NO: 2 
CABLE TESTED: B700 
SIGNAL LOSS: .01 
CABLE NAME: B700 
STANDARD DEVIATION: .13 

SUM 


This function takes one argument of type Number or 
Integer. It returns the sum of all the values entered for the 
attribute. Result type: Number or Integer. 


Attribute name: TOTAL_ PURCHASE 
Derivation. SUM (LINE_ITEMS.PRICE) 


ORDER NO: 36 

CUSTOMER NAME: Bunker Hill Garage 
PART NUMBER QTY LIST PRICE 
J-1111 5 15.00 
J-0504 4 25.00 


TOTAL PURCHASE: 175.00 


PRICE 
75.00 
100.00 


DESCRIPTION 
Spanner 
Wheel Lock 
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VARIANCE This function takes one argument of type Integer or 
Number. It returns the variance of the non-empty values for 
the attribute based on the equation 


S1 (Xi— X)° 
a nN 


where X is the average of the non-empty values and 77 is the 
number of non-empty values. Result type: Number. 








FIRST This function takes one argument of type String, Date, 
Time, Integer, Number, Enumerated, or Boolean, and 
returns the first value that was entered for that attribute. 
Result type: same type as argument. 


Attribute name: CONTACT 
Type: STRING 
Initial value: FIRST (CUSTOMER CONTACTS) 


NAME: Roman Olds Dealers 
CONTACTS: Dana Roman 
Lance Roman 


ORDER NO: 29 
NAME: Roman Olds Dealers © 
CONTACT: Dana Roman 





| 

LAST This function takes one argument of type String, Date, 

E = Time, Integer, Number, Enumerated, or Boolean, and 

a returns the last value entered for that attribute. Result type: 
ad same type as argument. 
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Mathematical 
Functions 
ABS This function takes one argument of type Integer or 
(x Number, It returns the absolute value of the argument. 
Result type: Integer or Number. 
EXP This function takes one argument of type Integer or Number 
iy and returns the value e (approximately 2.718) raised to the 
power of the argument. Result type: Number. 
INTEGER This function takes one argument of type Number and 
(x7 returns the integer portion of the argument. Note that this 
function does not necessarily round off the value. Result 
type: Integer. 
Attribute name: DOLLARS 
Initial value: INTEGER (DOLLARS__ &_ CENTS) 
DOLLARS & CENTS: 379 
DOLLARS: 3 
LN This function takes one argument of type Integer or Number 
(x) and returns its natural logarithm. Result type: Number. 
LOG10 This function takes one argument of type Integer or Number 
(x) and returns its logarithm base 10. Result type: Number. 
REM This function takes two arguments of type Integer or 
(x,W 








Number, divides the first by the second, and returns the 
remainder according to the formula: x-(yxINTEGER(x/y)). 
Result type: Number. 


REM (10, 3) = 1 
REM (667, 333) = .001 
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ROUND This function takes two arguments, the first, x, of type 

(4 Integer or Number, the second, y, of type Integer, and 
returns the first argument rounded to tenths (if y is greater 
than zero), to an integer (ify equals zero), or to multiples of 
ten (ify is less than zero). Result type: Number or Integer. 


a i 


ROUND (1732.421, 0) = 1732 
ROUND (1732.421, -1) = 1730 
SOUND (1732.421, -3) = 2000 
ROUND (1732.421, 2) = 1732.42 


i 


wy 








yy 


SQRT This function takes one argument of type Number or Integer 

(4) and returns the square root of the argument. If the 
argument is less than zero, the function returns NaN (Not a 
Number). Result type: Number. 


T 





UNIQUE_ID This function takes no arguments and returns the number of 
records that have been created in the file. You may use the 
number as a unique identifier for each record. Result type: 
Integer or Number, depending on what the attribute's type is. 


A good way to use UNIQUE__ID is to define an attribute of 
type Integer (with the DEFINE-NEW-ATTRIBUTE LONG-FORM 
command) and type UNIQUE_ ID into the Initial value 
field. The first record you create will have the value 1 for 
that attribute, the second record you create will have the 
value 2, and so on. 





a You can combine the value returned by the UNIQUE_ID 
' function with another value or expression. For example, if 
you want your records to be uniquely numbered starting at 


r a 1001, enter the following expression in the /nitial value field: 
— i 

{ UNIQUE_ID + 1000 

— 
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Date Functions 





ADD_INTERVAL. 


This function takes two arguments: the first is of type Date, 





DATE the second, x, of type Integer. It returns the date that is x 
(Date, x) number of days from the argument date (if x is negative, it 
returns a preceding date). Result type: Date. 
Attribute name: EXP_DATE 
Derivation: ADD_INTERVAL_ DATE (DELIVERY_DATE, 3) 
DELIVERY DATE: 01/27/85 
EXP DATE: 01/30/85 
DAY This function takes one argument of type Date and returns 
(Date) 


ee ee Se es a) ee 


DAY_OF_WEEK 
(Date) 


the day of the month. Result type: Integer. 


Attribute name: DAY_OF_MONTH 
Derivation: DAY (ORDER_DATE) 


ORDER DATE: June 14, 1980 
DAY OF MONTH: 14 


This function takes one argument of type Date and returns 
the number day of the week. Result type: Integer. 


Attribute name: NUMBER_OF_DAY_IN_ WEEK 
Derivation: DAY_OF_WEEK (DUE_DATE) 


DUE DATE: Monday, 6 August 1985 
NUMBER OF DAY IN WEEK: 2 
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INTERVAL_DATE 
(Date, Date) 


MONTH 


(Date) 


TEXT_DAY_OF_ 
WEEK 


(Date) 
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This function takes two arguments of type Date and returns 
the number of days between them. If the first argument is 
earlier than the second, the function returns a negative 
number. Result type: Integer. 


Attribute name: DAYS_ EMPLOYED 
Derivation: INTERVAL_ DATE (LAST_DAY_WORKED, 
FIRST_DAY_WORKED) 


FIRST DAY WORKED: 05/13/82 
LAST DAY WORKED; 02/04/85 
DAYS EMPLOYED: 998 





This function takes one argument of type Date and returns 
the number of the month in the year. Result type: Integer. 


Attribute name: MONTH_NUMBER 
Derivation: MONTH (ENTERED_ON_ DUTY) 


ENTERED ON DUTY: July 24, 1978 
MONTH NUMBER: 7 


This function takes one argument of type Date and returns 
the day of the week of that date. Result type: String. 


Attribute name: WHAT_DAY 
Derivation: TEXT_DAY_OF_WEEK (DATE__OF_BIRTH) 


DATE OF BIRTH. 25 APRIL 1980 
WHAT DAY: Friday 
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TEXT_MONTH 


(Date) 


This function takes one argument of type Date and returns 
the month for that date. Result type: String. 


Attribute name: MONTH_ PUBLISHED 
Derivation: TEXT_.MONTH (PUBLICATION_ DATE) 


PUBLICATION DATE: 06/25/85 
MONTH PUBLISHED: June 





TODAY 


This function takes no arguments and returns the present 
date (if you set the computer's clock correctly). Result type: 
Date. Don’t confuse TODAY the function with TODAY the 
data entry expression. When you fill in a record or selection 


criteria, you type TODAY as a shortcut to enter today’s date. 


When you type TODAY in a derivation expression or initial 
value expression, you are using the function TODAY. 





YEAR 
(Date) 





This function takes one argument of type Date and returns 
the year. Result type: Integer. 


Attribute name: WHAT_YEAR 
Derivation: YEAR (ORDER_DATE) 


ORDER DATE: 05/22/85 
WHAT YEAR: 1985 


a) a 
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Time Functions 





ADD_INTERVAL_ 
TIME 


(Time, x) 


Entering Information Into Forms 





141 


This function takes two arguments: the first is of type Time, 


the second, x, of type Integer. It returns the time that is x 


seconds from the argument time (if x is negative, returns a 


preceding time). Result type: Time. 


Attribute name; EXPECTED_ARRIVAL 


Derivation: ADD_INTERVAL_TIME (DEPARTURE, 5400) 


DEPARTURE: 9 am 
EXPECTED ARRIVAL: 10:30 am 








HOURS 


(Time) 





This function takes one argument of type Time and returns 


the hour of the day. Result type: Integer. 


Attribute name: MEAN_HOUR _OF_ BREAKDOWN 
Derivation: AVG (HOURS (BREAKDOWN. TIME_OF_DAY)) 


MACHINE: L-Sealer 


DESCRIPTION DATE 
No heat Dec 1 
Not sealing Dec3 
Jammed Dec5 | 


MEAN HOUR OF BREAKDOWN: 10 


TIME OF DAY 
11:20 am 

9:00 am 
10:00 am 
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INTERVAL_TIME This function takes two arguments of type Time and returns 

(Time, Time) the number of seconds between them. If the first argument 
is earlier than the second, the value of the function is 
negative. Result type: Integer. 


b 





Attribute name: HOURS_EFFECTIVE 
Derivation: INTERVAL_TIME (SYMPTOMS_RETURNED, 
WHEN_ADMINISTERED)/3600 


PATIENT: Robner 

MEDICATION: Ebullion 

WHEN ADMINISTERED: 10:30 pm 
SYMPTOMS RETURNED: 11:30 pm 
HOURS EFFECTIVE: 1 





MINUTES This function takes one argument of type Time and returns 
(Time) the minutes. Result type: Integer. 


Attribute name: CHARGE 

Type: NUMBER 

Initial value: (HOURS (IN_USE)»*60 + MINUTES (IN_USE)) « 
RATE_PER_MINUTE 


IN USE: 2:30 
RATE PER MINUTE: .13 
CHARGE: 19.50 





NOW This function takes no argument and returns the current ~ 
time (if your computer's clock is set correctly). Result type: 
Time. Don’t confuse NOW the function with NOW the data 
entry expression. When you fill ina record or selection 
criteria, you type NOW as a shortcut to enter the current 
time. When you type NOW in a derivation expression or 
initial value expression, you are using the function NOW. 


as 
SaaS This function takes one argument of type Time and returns 
me) 


the seconds. Result type: Integer. 
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Financial Functions 








FV This function takes three arguments of type Number or 
pe per pertod, Integer and returns the future value of an annuity, based on 
interest rate per per ; ; 

eres ale per period, the equation 
number of periods) 
(1 + interest)” — 1 


payment x : 
interest 





where 77 is the number of periods. Enter the interest rate as 
a number less than 1 (for example, .10 for 10 percent). 
Result type: Number. 


Attribute name: FUTURE_ VALUE 
Derivation: FV (PAYMENT, INT_RATE, # —OF_MONTHS) 





; ) PAYMENT: 600.00 © © # OF MONTHS: 360 conte 
- =i INTRATE:.0117 FUTURE VALUE: 3,326,218.17. 


— i The example shows that a payment of $600 per month at 
4 1.17% interest per month will yield $3,326, 218.17 after 360 
periods. 

I 


(principal, Integer and returns the interest rate per period. Result 
payment per period, 


| number of periods) 


a INTEREST This function takes three arguments of type Number or 


type: Number. 


Attribute name: INT_RATE 
Pi Derivation: INTEREST (PRINCIPAL, PAYMENT_PER_ YEAR, #_ YEARS) 
A 


PRINCIPAL: 60000 2 # YEARS: 30 
PAYMENT PER YEAR: 7200 ‘INT RATE: 0.12 


The example shows that if you take a loan for $60,000 and 
pay back $7200 a year over 30 years, your interest rate is 
12%. 
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PMT 


(present value, 
viterest per period, 
number of periods) 


PV 
(payment per period, 


interest rate per period, 


nuanber of periods) 


This function takes three arguments of type Number or 
Integer and returns the payment for the period, based on 
the equation 
; interest 
fatal ola 1 — (1 + mterest) 


where 7 is the number of periods. Result type: Number. 


Attribute name: PAYMENT 
Derivation: PMT (PRESENT_VALUE, INT_RATE, #_MONTHS) 


PRESENT VALUE: 80000 PAYMENT: 950.43 


INT RATE: .0117 
# MONTHS: 360 


The example shows that if you take a loan for $80,000 at an 
interest rate of 1.17% per month over 30 years, your 
payment per month is $950.43. 





This function takes three arguments of type Number or 
Integer and returns the present value of an ordinary 
annuity, based on the equation 


1 — (1 + interest)” 
interest 
where #7 1s the number of periods. Result type: Number. 


payment * 


Attribute name: PRESENT_VALUE 


Derivation: PV (PAYMENT_PER_ PERIOD, INT_RATE_PER_PERIOD, 
#__PERIODS) 


PAYMENT PER PERIOD: 220 
INT RATE PER PERIOD: .01 
# PERIODS: 36 


PRESENT VALUE: 6623.65 


The example shows that if you pay $220 a month over 36 
months on a loan with an interest rate of 1% per month, the 
loan is for $6623.65. 
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String Functions 








INDEX This function takes two arguments of type String and looks 

(String, String) for the first argument in the second. If it finds the first 
argument, the function returns the position in the second 
argument where the first argument begins. If the first 
argument is not found in the second argument, the function 
returns a zero. Result type: Integer. 








STRING This function takes any number of arguments of type String, 
(any number of arguments — Number, Integer, Date, Time, or Enumerated, and joins 
of any type but Boolean) them into one String. Result type: String. 


This function is very useful for combining two or more non- 
unique attributes into one unique attribute. Read A True 
Story in chapter 9, “Planning Your Database,” in Owner's 
Handbook I. 


Attribute name: CSZ 
Type: STRING 
Initial value: STRING (CITY, “, “STATE, “ “, ZIP) 


NAME: Medford Motor Service | 
STREET: 975 Abbey Rd. 

CITY: Medford 

STATE: MA 

ZIP: 02155 

CSZ: Medford, MA 02155 





SUBSTRING This function takes three arguments: the first of type 

(String, x, y) String, the second, x, and third, y, of type Integer. It 
returns the string that begins at the xth character and 
contains y characters. Result type: String. 


Attribute name: SHORT_ZIP 
Derivation: SUBSTRING (LONG_ ZIP, 1, 5) 


LONG ZIP: 19803-4237 
SHORT ZIP: 19803 
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Edit mode allows you to enter and change information in 
forms. Chapter 2, “Introduction for the Impatient User,” in 
Owner's Handbook I, describes the basics of Edit mode. 
This chapter describes the details of Edit mode. 


Most of the time, you use Edit mode to enter or edit 
information in a form. The first section, Entering and 
Editing Information, describes how to use Edit mode tn this 
way. 


Edit mode, like Format mode, also has commands you can 
issue, but these are rarely necessary. These commands are 
described in the second section, Edit Mode Commands. 


Cornerstone forms are made up of fields. You enter values in 
these fields. (We use the term value to refer to anything you 
enter into a field, including Number, Integer, String, Date, 
Time, Enumerated, and Boolean values.) The previous 
chapter, “Entering Information Into Forms,” tells you what 
values you can enter; this section describes how to enter 
them. 


The Edit Mode Status Line 
The top status line contains the following information 
whenever you're in Edit mode. 


EDIT CITY SEINE OES 
Type-in style: | 
The field name Ht oe field. either insert 
of the current fie orouersitke 


— 


EDIT 3rd LINE_ITEMS.LIST_PRICE NUMBER _INS 
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Edit Mode 


| Introduction 


Entering and 
Editing 
Information 


The asterisk indicates 
you've changed the 
current field 
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Typing Values 

To enter a value, simply type it in. You can press 

| (BACKSPACE) to erase the previous character, (RUB-WORD) to 
erase the previous word, and (DELETE-CHAR) to erase the 

| current character. 


| You can move the cursor within a value using the arrow 

| 

| keys: (ARROW-LEFT), (ARROW-RIGHT), (ARROW-UP), and 

_ (ARROW-DOWN). Ctrl-A moves the cursor to the start of the 





| current line, and Ctrl-E moves the cursor to the end of the 
| current line. 


At any point, you can press the (OPTIONS) key to display a 
description (and possibly a list) of the values you can enter in 
the current field. 


If the cursor is in the middle of a value when you type, your 
type-in style determines whether what you type replaces the 
existing text, or is inserted in the text. When the type-in 
style is overstrike (indicated by an OVS on the status line) 
characters replace existing text, and (BACKSPACE) replaces 
the previous character with a space. When the type-in style 
is insert (indicated by an INS on the status line) characters 
are inserted in the text, and (BACKSPACE) deletes the 
previous character. 


Anytime you try moving the cursor off of a value you’ve 
edited, the system checks the value for validity. If the value 
is acceptable, the system stores it away; otherwise, 
Cornerstone displays an error message. You must fix the 
problem before Cornerstone will let you move the cursor to 
another value or field. 


If you mistakenly edit a value and want to restore the 
original value, press (CANCEL) and select the VALUE option. 
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(You can only do this before you’ve moved the cursor off of 
the value. ) To erase the text to the right of the cursor, press 
Ctrl-K (for CLEAR REST-OF-VALUE). 







When you're done editing, press (DONE). The system will 
return to the previous mode. If you neglected to enter a 

value for a mandatory field, Cornerstone remains in Edit 
mode, positions the cursor on the mandatory field, and 
displays an error message telling you to enter a value. At 

this point, you should either enter a value, or press (CANCEL) 
and select the FORM option. (CANCEL FORM may clear the 
entire form, in which case you will be asked to confirm the 
operation. ) 











Moving From Field to Field 

The easiest way to fill out a new record form is to type in 
values for each field, pressing (ENTER) after each value. In 
general, pressing (ENTER) moves the cursor to the next 
field, except 


O Ifthe cursor is on the last editable field of the form, 
pressing (ENTER) causes Cornerstone to leave Edit 
mode, as if you had pressed (DONE). 










O Ifthe cursor is in a multi-valued field, pressing (ENTER) 
; either moves the cursor to the next value; inserts a 
ma new (empty) value if the cursor is on the last value and 












the value isn’t empty; or deletes the last value if it is 
i empty. To use this, just press (ENTER) each time you 
al ‘ want to enter a new value, and press (ENTER) twice 
when you're done entering values for the field. 


oe O Ifthe cursor is within the last field of a (multi-valued) 
‘ subform, pressing (ENTER) inserts a new subform for 
a you to fill out. (If the last subform is empty, it is 
—— deleted.) To use this, just press (ENTER) after you 
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| 





enter each value, and sequence through the last 
(empty) subform with (ENTER) when you're done 
entering subforms. 


You can move the cursor around the form using the arrow 
keys. The (NEXT), (PREVIOUS), (FIRST), and (LAST) keys 


| move the cursor to the corresponding field in the form. 
| When moving the cursor, Cornerstone skips over any fields 


that are not editable (such as derived fields). 
If the cursor isn’t on any field, pressing one of these keys will put the 
cursor ona field. 
You can use the scrolling keys to move the form up or down 
within the display, and left or right. 


Checking Values 


Before Cornerstone lets you leave a field, it checks to see 
that 


0 Your entry is of the appropriate type 


O Your entry meets any constraints you defined for the 
field 


If your entry does not pass these tests, Cornerstone 
positions the cursor where the error occurs and displays an 
error message. You can press (HELP) at this point to get 
assistance. 
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Command Keys 
The following table summarizes the command keys available 
in Edit mode. 


Command Key Description 
(HELP) Display information about the 


current field and form, and display 
general help on editing 


(OPTIONS) Display information describing what 
you can enter in the current field 
(BACKSPACE) Delete the previous character 
(RUB-WORD) Delete the previous word 
(DELETE-CHAR) Delete the current character 
(CANCEL) Restore the previous value, if any, or 


cancel editing the form 


(DONE) Leave Edit mode and return to 
previous mode 


(ENTER) Move the cursor to the next editable 
field, or create a new value for a 
multi-valued field, or create a new 
subform, or exit from Edit mode if 
on the last editable field 


(NEXT) Move the cursor to the next editable 
field 

(PREVIOUS) Move the cursor to the previous 
editable field 

(FIRST) Move the cursor to the first editable 
field 
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Command Key 
(LAST) 
(ARROW-LEFT) 


(ARROW-RIGHT) 


(ARROW-UP) 





(ARROW-DOWN) 





(PAGE-FORWARD) 





Description 

Move the cursor to the last editable 
field 

Change the type-in style from insert 
to overstrike or vice versa 





Move the cursor to the previous 
character 


Move the cursor to the next 
character 


Move the cursor up one line within 
the current field, or to the last field 
on the previous line 


Move the cursor down one line 
within the current field, or to the 
first field on the next line 





Scroll the form forward one 
screenful 





{PAGE-BACKWARD) 


Scroll the form backward one 
screenful 





(SCROLL-FORWARD) 
(SCROLL-BACKWARD) 


(WINDOW-LEFT) 


(WINDOW-RIGHT) 





(COMMAND) 


Scroll the form forward one line 
Scroll the form backward one line 


Move the window on the form to the 
left (the form moves to the right) 


Move the window on the form to the 
right (the form moves to the left) 


Display a menu of commands to 
choose from (described in the 
section Edit Mode Commands) 
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Control Keys 

The following control keys simplify editing a form. To use a 
control key, such as Ctrl-A, hold down the Ctrl key and press 
A. Control keys provide a shorthand way to issue commands 
(instead of pressing (COMMAND) and then entering a 
command from the menu). The corresponding commands 
are described in more detail in the section Edit Mode 
Commands. 


Control Key Corresponding Command 
Ctrl-A START-OF LINE 

Ctrl-D COPY PREVIOUS VALUE 
Ctrl-E END-OF LINE 


Ctrl-K CLEAR REST-OF-VALUE 


rr Ctrl-N INSERT 

ot Ctrl-U RECOMPUTE 

r Ctrl-X DELETE 

[ 3 

—- Options 

| Whenever you are filling out a form, you can press the 

r mt (OPTIONS) key to get information describing what you may 
—_7 . ¥ . 

[= enter in the current field. 

r am If you are entering a Number, Integer, String, Date, Time, 

—— Enumerated, or Boolean value, a message describes how to 

enter a value of the appropriate type. The message also lists 

- oi any constraints in effect for the current field. c= The 

ae (OPTIONS) key is especially useful when editing an 


enumerated field, or a field with a cross-file range 
constraint, because Cornerstone displays a list of allowed 
values. =1 You can then enter one of the values in the list. 
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If you are editing a selection form (under Select mode), 
Cornerstone displays the various kinds of selection 
_ expressions you may enter. 


eSranis If you are entering a derivation, initial value, or range 
constraint expression, Cornerstone displays exactly what you 
may enter at that point in the expression. <2 As you enter 

| the expression, you may press the (OPTIONS) key repeatedly; 
_ each time you press it, Cornerstone displays a new list of 
options. 


Help 

Whenever you are filling out a form, you can press the 
(HELP) key to get a description of the form, followed bya 
description of the field you are editing. For record forms, 
Cornerstone displays the descriptions you entered for the 
current file and attribute when you defined your database. 
The Help message tells you when the current field is 
mandatory or requires unique values. 


Edit Mode This section lists the commands available in Edit mode. To 
Commands | enter one of these commands, you must first press the 
(COMMAND) key, then select the command from the menu. 
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Command 


INSERT 


DELETE 


CLEAR 


COPY 


RECOMPUTE 


START-OF 


END-OF 


Description 


Insert a new VALUE (in a multi- 
valued field) or SUBFORM, BEFORE or 
AFTER the cursor location. 


Delete the current VALUE (in a multi- 
valued field) or SUBFORM. 


Erase the REST-OF-VALUE, or 
remove all values from the entire 
FORM. 


Copy the previous value. For a 
single-valued field or the first entry 
for a multi-valued field, copy from 
the previous record in the update 
set. For subsequent entries ina 
multi-valued field, copy the previous 
value from the current record. For 
fields in a subsequent subrecord, 
copy from the previous subrecord of 
the current record. You may edit the 
value after it is copied. Press 
(ENTER) when you are satisfied with 
the entry. (This command is only 
available under Update mode. ) 


Recompute the initial value of the 
current field. (This command is only 
available under Update mode. ) 


Move the cursor to the beginning of 
the current LINE or VALUE. 


Move the cursor to the end of the 
current LINE or VALUE. 
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Command Entry 
and System 
Response 
The Screen Layout The Display 
The Cornerstone screen is divided into several areas, used Screen 


to display different kinds of information. From the top to 
bottom, they are the 
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Error line. This line is used to display an error 
message whenever an error occurs. The message 
describes the problem and usually suggests a 
corrective course of action. You can press the (HELP) 
key to get additional help about the error. 


Command line. Cornerstone uses this line to display 
commands. As you select options from the menu, your 
choices are displayed on the command line. When you 
press (ENTER), Cornerstone displays the symbol [ok] 
to indicate that it has accepted your command and is 
executing it. When the Cornerstone finishes executing 
the command, it erases the command line and waits 
for you to issue another command. You can press 
(CANCEL) to erase the command line and enter another 
command. 


Prompt line. Cornerstone used the prompt line to 
tell you what you must enter next, such as an attribute 
name or one of the options in the menu. 


Menu window. The menu window displays a list of 
options for you to choose from. You can select a menu 
option using the arrow keys and (SPACE), or by simply 
typing the option you want. Anytime a menu option is 
highlighted, you can select it by pressing (SPACE). An 
ellipsis (...) in the menu window indicates that there 
are more options than fit in the menu window. To see 
all the menu options, press (OPTIONS). 
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Errar line 


Prompt tine 
Menu window 
Top status line 
Data area 


Bottom status line 








Top status line. The top status line tells you what 
mode the system is in, and contains other information 
depending on the mode. 


Data area. The data area is where all the action is. 
This area comprises most of the screen, and is used to 
display whatever is going on, which depends on what 
mode the system is in. For example, in View mode, 
the data area is used to display your report, and any 
time you press (HELP), it’s used to display the help 
message. 


Bottom status line The bottom status line contains 
the current file, previous mode, and the number of 
files viewed. If you are have included Status History 
(see chapter 11, “Customization and Initial Mode,” in 
Owner's Handbook I), this status line is omitted from 
the screen. 


No CHOICE is HIGHLIGHTED. You should enter or select an optien. 










UPDATE — 


NAME 


Which records do you want to UPDATE? 
as NEW-RECORD CURRENT-RECORD ALL 
FLAGGED UNFLAGGED 
Command line 


| Newton Auto Rentals 
Lange s Motorworld 
Watertown Car Center 
Bergman's Antique Autos 
Medford Motor Service 
Roman Olds Dealers 
Tosh’s Service Center 
Roxbury Auto Body and Repair 
Hal's Foreign Auto Repair 
Lexington Auto Service 
Concord Bus Line 

T Motors 

Hanover Service Station 
Busiker Hill Garage 


ee tee 


File. CUSTOMER Previous made: Initial Files viewed | 
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Colors 

Cornerstone displays information in either color or 
monochrome. To get Cornerstone to use color, change 
Screen Color in the customization form from “Monochrome” 
to “Color.” Cornerstone then displays text in white on a blue 
background. Highlighted text is black on a white background. 


You can select other color combinations if you wish. See 
chapter 10, “Reinstallation and Saving Space,” for details. 


Color only works if you have a color monitor. 


Whenever the cursor lies on the command line, 
Cornerstone is waiting for you to enter a command. You can 
enter commands using the keyboard, the arrow keys, or a 
combination of both. 


Keyboard Entry 

To enter commands from the keyboard, simply type the 

name of the command. Entering commands this way is easy, 

since 

O You only have to type enough characters to uniquely 

identify one of the options in the menu. When you have 
done so, Cornerstone will highlight this option, and all 
you have to do to select it is press (SPACE). 
Cornerstone completes your choice, and displays it on 
the command line. 


As you type, Cornerstone eliminates choices that do 
not match what you have typed. Cornerstone 
continually adjusts the menu to contain only options 
that are possible given what you have typed. 


Entering 
Commands 
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If you type a character that doesn’t match any of the 
choices, Cornerstone ignores the character, displays 
an error message, and prompts you to type a valid 
character. 


Cj 


Any time the choice you want is highlighted, you can 
simply press (SPACE) to select it. 


O You can use (BACKSPACE) and (RUB-WORD) to delete a 
character or word you have entered on the command 
line. 


O You can press (CANCEL) to erase the entire command 
line and enter a new command. 


Using the Arrow Keys 

You can use the arrow keys to select commands instead of, 
or in addition to, typing them in. As you press the arrow 
keys, Cornerstone highlights different choices in the menu. 





When you press an arrow key, you are moving the menu 
cursor. The menu cursor is a highlighted rectangle that lies 
either on one of the options in the menu (called the current 
option) or in the upper left-hand corner of the menu window 
where it does not rest on any choice. 





To enter commands using the arrow keys, all you have to do 
Is move the menu cursor to the menu option you want, and 
press (SPACE). Just as with type-in, (SPACE) selects the 
highlighted current option, if any. 


QO When the menu contains more options than fit in the 
menu window at one time, Cornerstone indicates this 
by displaying an ellipsis (...) in the menu. If you press 
one of the arrow keys in this situation, Cornerstone 
may scroll the menu in order to show additional 


choices. You can always press (OPTIONS) to see all the 
choices at once. 
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O The arrow keys wrap around the menu. If you use the 
(ARROW-DOWN) key on the bottom line of the menu, the 
cursor moves to the top of the next line. If you use the 
(ARROW-LEFT) key at the extreme left, the cursor will 
appear on the right. 


You can enter commands using any combination of type-in 
and arrow keys that you find convenient. 


When your command is complete, Cornerstone prompts you 
to press (ENTER). When you do so, Cornerstone displays the 
symbol [ok] following the command to indicate that it has 
accepted your command and is executing it. If for some 
reason Cornerstone cannot execute the command you 
entered, it displays an error message describing the 
problem. (You can press (HELP) to get additional 
information.) When Cornerstone finishes executing the 
command, it clears the command line and waits for you to 
enter another command. 


Help 
Anytime Cornerstone is waiting for you to do something, 
you can press the (HELP) key for assistance. 


If you press the (HELP) key when Cornerstone is waiting for 
you to enter a command or select an option from the menu, 
Cornerstone will describe the options in the menu. If the 
menu cursor lies on a particular option when you press 
(HELP), Cornerstone describes that option in detail; 
otherwise it briefly describes all the options. 
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If you press (HELP) while editing a form, Cornerstone tells 
you about the form and the field you are editing. Press 
| (HELP) again to get general help on editing. If you press 
| (HELP) a third time, Cornerstone will display a keyboard 
map showing where the Cornerstone command keys are on ioe 
your keyboard. 


_ Hii 


If you press (HELP) while an error message is displayed on 
the error line, Cornerstone will provide additional 
information describing the problem, and usually suggests 
corrective action. 


Options 
Anytime you press the (OPTIONS) key, Cornerstone tells you 
what your options are. 


i) 
ah — Te - 


iq 
' 
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If you press (OPTIONS) when Cornerstone is waiting for you 
to enter a command, Cornerstone displays the entire menu 
of choices that are available to you. 


If you press (OPTIONS) while editing, Cornerstone describes 
what you can enter in the current field, and, for enumerated 
fields and fields whose values are restricted to those in 
another file, displays a list of values for you to choose from. 
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The (COMMAND) Key 

Cornerstone usually tries to interpret anything you type as 
the name of a command or other menu option. There are 
two exceptions to this rule. 






O In Edit mode, whatever you type goes into the form 
you're editing as a value for the current field. 





O In Format mode, what you type goes into the form 
you're designing as constant text that is displayed in the 
form. 









Because Cornerstone interprets what you type in a special 

way whenever the system is in Edit mode or Format mode, 

a... jl you must first press the (COMMAND) key to issue a 

ig command. When you press (COMMAND), you tell 
Cornerstone, “hey, I want to issue a command.” 








Tn Cornerstone obliges by displaying a menu of commands for 
= you to choose from. Anything you type is now interpreted as 
= a command, and you enter the command in the usual 

- =a fashion. After you issue a command and Cornerstone 

if executes it, Cornerstone returns to its original mode of 

+ interpretation, and you must press (COMMAND) again to issue 


— another command. 
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_ Command Keys ond 
| Some Cornerstone commands can only be executed by = 
pressing a key, called a command key. The command keys | 
are listed below. Your keyboard template and the Quick nl 
Reference Card show where the command keys are located a 
on your keyboard. Many of them lie on the numeric keypad, 
so make sure Num Lock is off. a 


Key Function =: 









(HELP) Display an appropriate help message 


— 


(OPTIONS) Display a complete menu of choices 





1 
r 


(BACKSPACE) Delete preceding character 





(RUB-WORD) Delete preceding word 
(DELETE-CHAR) Delete current character 


(CANCEL) At command level, cancel current 
command; while editing, restore 
previous value or clear form 





(DONE) Return to previous mode 


(ENTER) Execute the current command; in 
Edit mode, enter value and move to 
next value 








(NEXT) Go to next element in the set; in 
Edit mode and Format mode, go to 
the next field 








(PREVIOUS) Go to previous element in the set: in 
Edit mode and Format mode, go to 
the previous field 


ARAARAAR EI 








(FIRST) 





(LAST) 


(INS/OVS) 
(FLAG/UNFLAG) 
(COMMAND) 
(ARROW-LEFT) 
(ARROW-RIGHT) 
(ARROW-UP) 
(ARROW-DOWN) 


(PAGE-FORWARD) 


(PAGE-BACKWARD) 


(SCROLL-FORWARD) 


(SCROLL-BACKWARD) 


(WINDOW-LEFT) 


(WINDOW-RIGHT) 


Go to first element in the set; in 
Edit mode and Format mode, go to 
first field 
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Go to last element in the set; in Edit 
mode and Format mode, go to the 


last field 


Change type-in style 
Flag or unflag record 


Leave editing to issue one command 


Move the cursor to the left 


Move the cursor to the right 


Move the cursor up 


Move the cursor down 


Scroll the data area forward one 


screenful 


Scroll the data area backward one 


screenful 


Scroll the data area forward one line 


Scroll the data area backward one 


line 


Move the window on the data area to 


the left 


Move the window on the data area to 


the right 
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Control Keys 
Some Cornerstone commands can be issued by pressing a 


control key, as well as in the usual fashion. The control key is 


simply a shorthand for some command. This makes tt 
easier to execute certain frequently used commands, 


| especially in Edit and Format modes, where you would 


otherwise first have to press (COMMAND) in order to issue 


| the command. 








Control Key Command Description 

Ctrl-A START-OF Move to start of line 

Ctrl-D COPY Copy value from previous 
record 

Ctrl-E END-OF Move to end of line 

Ctrl-F OTHER-FORM — Move to the other report 
form 

Ctri-K CLEAR Clear the value or form 

Ctrl-L REDISPLAY Redisplay the screen 

Ctrl-N INSERT Insert fields, lines, or 
subforms 

Ctrl-R SET-CHARAC Set field characteristics 

Ctrl-U RECOMPUTE Recompute the initial value of 
a field 

Ctrl-V MOVE Move a field or line 

Ctrl-W ADJUST-WIDTH Adjust the width of a field 

eae ee OU OF AICI 

Ctrl-X DELETE Delete fields, lines, or 
subforms 

Ctrl-Break ABORT Abort the current process 





" 
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This chapter outlines the structure of Cornerstone. It 
contains a list of all the modes and the commands available 
in each. There is nothing described here that is not also 
provided in the help messages, but we include this summary 
for those who find it easier to read text on a printed page 
than phosphor traces on a luminescent screen, and also for 
those who have elected to delete their help file in order to 
gain more disk space. 


INITIAL 









UTILITIES 


SELECT 


Format mode is 
available under FORMAT 
View, Update 


Select, and 
Print modes 


Edit mode is used 
throughout the 
T 
EPI system 
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Cornerstone 
Structure 


Introduction 


Foes BACKUP. 
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Cornerstone MODE TASKS 
Modes 


Initial mode Enter Cornerstone 
Exit from Cornerstone 


| 








View mode Look at records 
Create reports 
Sort records 
Create summaries and derived attributes 
Print reports 
Enter Update, Select, Print, Format 
modes 
Enter second-level View mode 





Select mode Specify selection criteria for working set 
Enter Format mode to format the selection 


form 
RE OSL, ERK Sen) 


Update mode Create, change, and delete records 
Enter Format mode to format the update 
form 


Enter second-level View mode 








Edit mode Fill out or edit a form 





Format mode _ Design your own forms 








Define mode _ Define files, attributes, and relationships 


Change or delete files and attributes 
Remove relationships 


Print mode Modify print characteristics 
Create and alter print devices 


Enter Format mode to format the report 
title 






Backup mode Back up and restore files in your database 


Convert mode Convert foreign files to Cornerstone f iles 


and vice versa 
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All the modes except Backup, Convert, and Edit modes are 
discussed in detail in Owner's Handbook I. Backup, Convert, 
and Edit modes are described in this volume. 


v4 


Initial Mode The Modes and 
Initial mode is the starting mode of Cornerstone. From | Their 

Initial mode, you can enter View or Define modes, and you Commands 

can use any of the utilities, such as Backup and Convert. You 
must return to Initial mode in order to exit the system. The 
ALL-DONE command, available in most modes, returns the 
system to Initial mode. 


ul 


. 





> ; = 
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see COMMAND DESCRIPTION 
a 
ae VIEW View the records ina file 
a |) DEFINE Define files and attributes 
oe 
" a CUSTOMIZE Customize the system 
1" DELETE Delete formats, selection criteria, 
a Pe or printing devices 
UTILITIES Use one of the utilities 


BACKUP/RESTORE Back up database files 


Hien ll 
Ye 





= CONVERT Convert foreign files to and from 
hae Cornerstone files 

_ar RECOMPUTE Recompute initial values for 
Le attributes 
——— 
i) ° NEW-RECORD Create one or more records in a file 

NEW-RECORD "3s St SS ee 

ie EXIT Exit from Cornerstone 

4 a 
pe 








176 Cornerstone Structu 


re 


| View Mode 

| View mode is the basic mode you use to work with a 
particular file. From View mode, you can get to the other 

| major modes of the system, Update mode and Select mode. 
| You can issue commands that manipulate your report, either 
by changing the appearance of the report format or by 

| selecting particular records to include. In View mode, you 
can’t do anything to alter the information contained in your 
database. 


COMMAND DESCRIPTION 











UPDATE Create, alter, or delete records in 
the file 

SELECT Select records in the file for viewing 

a ee re OL VIC WINE: 

VIEW View records in another file 

COLUMN Create a columnar report format 
showing selected attributes 

DETAILED Create a detailed report format 
showing selected attributes 

USE Use a saved format or selection 
criteria 

SAVE Save the current format or selection 
criteria 
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COMMAND 


REPO 


RT 


SUBTOTAL 


Cornerstone Structure 


DESCRIPTION 
Issue a reporting subcommand 


Compute subtotals for the report 








TOTAL Compute totals for the report 
FORMAT Design your own report format 
CALCULATE Create or change a derived attribute 
HIDE Hide a report element 
SHOW Show a hidden report element 

SORT Sort records in a specific order 

PRINT Print a report or set up print 

characteristics 
ALL-DONE Return to Initial mode 
(NEXT) Move the record cursor to the next 


(PREVIOUS) 


report element 


Move the record cursor to the 
previous report element 





(FIRST) Move the record cursor to the first 
report element 
(LAST) Move the record cursor to the last 


report element 





(FLAG/UNFLAG) 


(DONE) 


Flag or unflag the current record 


Return to the previous mode 
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Update Mode 
Update mode allows you to modify the information contained 
in your database. This includes creating, changing, or 
deleting records from the current file. 


| COMMAND DESCRIPTION 























EDIT Edit the current record oi 
VIEW View the records in another file 
| USE Use a saved format to update records 
| SAVE Save the current update format 
| PRINT Print the current or all records in the 
update set 








NEW-RECORD Create a new record in the file 
































DELETE Delete one or all update records 

UNDELETE Undelete records marked for deletion 

DETAILED Create a detailed update form with selected 
attributes 

FORMAT Design your own update format 

INIT-VALUE Change the initial value expression for an 
attribute 

ALL-DONE Return to Initial mode 

(NEXT) Display the next record in the update set 

(PREVIOUS) Display the previous record in the update 
set 

(FIRST) Display the first record in the update set 

(LAST) Display the last record in the update set 

(DONE) Leave Update mode 
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Select Mode 
- Select mode allows you to enter specific selection criteria 
t att which Cornerstone can use to select records from your 
ih database. 
P ie COMMAND DESCRIPTION 
EDIT Edit the current selection form 
as | 
= USE Use a saved format or selection criteria 
| 
a SAVE Save the current format or selection criteria 
I" = DELETE Delete one or all selection forms 
; DETAILED Create a detailed selection form showing 
selected attributes 
FORMAT Design your own selection form 


CALCULATE Create or change a derived attribute 
AND-FORM Create an AND-FORM 


OR-FORM Create an OR-FORM 

NEGATE Negate the current selection form 
PRINT Print one or all selection forms 

(NEXT) Display the next selection form 
(PREVIOUS) Display the previous selection form 
(FIRST) Display the first selection form 

(LAST) Display the last selection form 

(DONE) Return to View mode with the specified 


working set 





180 Cornerstone Structure 





| Edit Mode | 

_ Anytime you are filling out or editing a form, the system 1s 

| in Edit mode. In Edit mode, you type information directly 

| into the form. You generally never have to issue a command, 
since you can use Edit mode just by typing and pressing 

| (ENTER) or one of the arrow keys to move to another field. If 
you want to issue a command in Edit mode, you must first 
press the (COMMAND) key. 


| COMMAND DESCRIPTION 











INSERT Insert an additional value or subform 
| 
DELETE Delete a value or subform 
CLEAR Erase the rest of the current value or clear 


the entire form 


COPY Copy the value for this field from the 
previous record 


RECOMPUTE Recompute the initial value for the current 

















field 
START-OF Move to the start of the line or value 
END-OF Move to the end of the line or value 
(NEXT) Move to the next field 
(PREVIOUS) Move to the previous field 
(FIRST) Move to the first field 
(LAST) Move to the last field 
(INS/OVS) Change type-in style to insert or overstrike 
(CANCEL) Cancel value or entire form 
(DONE) Leave Edit mode 
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Format Mode 

In Format mode, you can design you own form. You can 
move fields around and type text into the form. You can 
insert or delete lines and fields. Just as with Edit mode, to 
enter a command you must first press the (COMMAND) key. 


COMMAND DESCRIPTION 


DETAILED Create a detailed form 

COLUMN Create a columnar form 

MOVE Move afield or line 

INSERT Insert a field, subform, or lines 

DELETE Delete a field, lines, subform, or the form 
CALCULATE Create or change a derived attribute 
PRINT Print the form or a grid 


ADJUST-WIDTH Adjust the width ofa field 


SET-CHARAC Set the characteristics of a field 


START-OF Move the cursor to the start of the current 
line or field 
END-OF Move the cursor to the end of the current 


line or field 


OTHER-FORM Move the cursor into the other form 


(NEXT) Move the cursor to the next field 
(PREVIOUS) Move the cursor to the previous field 
(FIRST) Move the cursor to the first field 
(LAST) Move the cursor to the last field 
(INS/OVS) Change the type-in style 

(DONE) Leave Format mode 
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Define Mode 

Define mode is the mode in which you define your database 
to Cornerstone. You can create, alter, or delete files and 
attributes, and you can define and remove relationships 


; 

















between files. Define mode has three levels: Top level, File a a 
level, and Subfile level. 
| © At Top level, you can work with files in your database. % i mod 
O At File level you can work with attributes in a file. 

| © At Subfile level, you can work with subattributes in a =— 
subfile. | 
| COMMAND DESCRIPTION — — 
- . L — 
Top level DEFINE-NEW-FILE Define a new database file 
commands REDEFINE-FILE Change the definition of a — 
database file | 
DELETE-FILE Delete a database file — 
PRINT Print the definition of one } 
or more files i 
ALL-DONE Return to Initial mode sae 
(NEXT) Highlight the next file in ~— 
the display ) 
} 

(PREVIOUS) Highlight the previous file 
in the display i 
(FIRST) Highlight the first file in the | 
display — 
(LAST) Highlight the last file in the 
display —— 
(DONE) Return to Initial mode ! 





a 
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1 COMMAND DESCRIPTION 
‘ | _ DEFINE-NEW-ATTRIBUTE Define a new attribute File level 
| REDEFINE-ATTRIBUTE Change the definition of an commands 
e— attribute 
DELETE-ATTRIBUTE Delete an attribute 
=== DEFINE-RELATIONSHIP Define a relationship to 
another file 





i 
“4 


REMOVE-RELATIONSHIP Remove a relationship to 
another file 





PRINT Print the definition of one 
or more attributes 


; 
| 























T =i ALL-DONE Return to Initial mode 
ae (NEXT) Highlight the next attribute 
<i in the display 
— (PREVIOUS) Highlight the previous 
attribute in the display 
l =5 (FIRST) Highlight the first 
attribute in the display 
Ri = (LAST) Highlight the last 
attribute in the display 
—t (DONE) Return to Top level of 
er ll Define mode 
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Subfile level 
commands 





COMMAND 


DEFINE-NEW-SUBATTRIBUTE 


DESCRIPTION 


Define a new subattribute 





REDEFINE-SUBATTRIBUTE 


Change the definition of a 
subattribute 





DELETE-SUBATTRIBUTE 


Delete a subattribute 





DEFINE-RELATIONSHIP 


Define a relationship to 
another file 








REMOVE-RELATIONSHIP 


Remove a relationship to 
another file 














PRINT Print the definition of one 
or more subattributes 

ALL-DONE Return to Initial mode 

(NEXT) Highlight the next sub- 





(PREVIOUS) 





attribute in the display 





Highlight the previous sub- 
attribute in the display 





(FIRST) 


Highlight the first sub- 
attribute in the display 





(LAST) 





Highlight the last sub- 
attribute in the display 





(DONE) 


Print Mode 


Return to File level of 
Define mode 


In Print mode, you can set characteristics that determine 
how your report is printed, and you Can create or alter print 
devices, which describe your physical printer to 


Cornerstone. 
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COMMAND 
EDIT 

PRINT 
FORMAT 
SHOW 
DEVICE 
ALL-DONE 


(DONE) 


Convert Mode 


Cornerstone Structure 


DESCRIPTION 


Edit the print characteristics form 





Print the report to disk or printer 
Create a format for the title of the report 
View the report title 

Create or alter a print device 

Return to Initial mode 


Leave Print mode and return to View mode 


The Convert utility allows you to convert information in your 
Cornerstone files to or from foreign file formats that can be 
used by other software products. 


You can import data from the following formats: 
dBase II, PFS, 1-2-3, DIF, MailMerge, SDF, and TEXT. 


You can export data to all of the above formats except 
dBase II, PFS, and TEXT. 


COMMAND 


CONVERT 


DESCRIPTION 


Convert records to or from Cornerstone 
format 





CUSTOMIZE 
ALL-DONE 


(DONE) 


Customize the way conversion works 
Return to Initial mode 


Leave Convert mode and return to Initial 
mode 
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Backup Mode : 
The Backup utility allows you to create backup copies of 
your database files, which you can restore at a later time. 
Backup copies are a safeguard against lost or damaged data. 


_ You can also use the Backup utility to compress your 
database files and gain more disk space. 

















| COMMAND DESCRIPTION 
BACKUP Back up your database onto another 
diskette or directory 
RESTORE Restore a previously backed-up 
database 
REORGANIZE Reorganize a file to compress it and 
save disk space 
EXECUTE Start the backup 
DRIVE Set a new disk drive or directory 
name 
SES AE RE Bee ee eR era Ta Wael 
SELECT Select specific records to back up 
SORT Specify an order to back up the 
records in 
ALL-DONE Return to Initial mode 
(DONE) Leave Backup mode and return to 
Initial mode 
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This chapter offers solutions to problems you may have 
encountered while installing Cornerstone. It also explains 
how to write a customized batch file to run Cornerstone, 
how to delete certain files to save space, and how to reinstall 
the system after a crash. 


Hard Disk: Terminating the Batch Job 





If you decide to terminate the batch job SETUPHD. BAT (by 
pressing Ctrl-Break), some directories may already have 
been created and some files copied. Terminating the batch 
job does not automatically remove any directories that may 
have been created, nor does it delete files. 


The following sequence of DOS commands removes all 
directories and files that may have been copied to your hard 
disk before you terminated the batch job. Which directories 
and files were created depends on when you pressed 
Ctrl-Break. If DOS responds to any of these commands with 
“File not found” or “Invalid directory,” you can assume that 
you terminated the batch job before they were created. 
When DOS asks “Are you sure?” (that you want to delete 
+), answer “Y”. 


Remove the write-protect sticker from the Cornerstone 
system diskette and insert the diskette in drive A, then 
issue these commands: 

C)CD \.CORNER 

C) REMOVE 


Introduction 


Solutions to 
Installation 
Problems 
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Take the Cornerstone system diskette out of drive A and 
put the write-protect sticker back on it. Next, issue the 
commands 

C)CD \.CORNER 

C)DEL SAMPLE\«.# 

C)RD SAMPLE 

C)DEL CLIENT\ +s. 

C)RD CLIENT 

C) DEL SALES\\«. + 

C)RD SALES 

C)DEL BEGIN135\#.* 

C)RD BEGIN135 

C) DEL BEGIN79\ «. * 

C)RD BEGIN79 

©). CDar 

C) DEL CORNER\ x. * 

C)RD CORNER 








Error Messages 

If you make a mistake while installing Cornerstone, you may 
get a DOS error message. Here are the error messages you 
are most likely to get, with solutions. 











Bad command or file name. Be sure you type the 
command correctly, and that the diskette in drive A is 
the correct one. 








Drive not ready on device B. You entered the 
CORNER command with no diskette at all in drive B. 
The Cornerstone system diskette should be in 

drive B. 
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Not ready error reading drive B. You used the 
DOS COPY command to make a copy ofa data 
diskette, but there is no diskette in drive B. 


Write protect error writing drive B. The diskette 
in drive B has a write-protect sticker on it. You must 
remove the write-protect sticker in order to copy data 
onto the diskette. 


If you inadvertently delete the Cornerstone system files 
from your hard disk, you can copy just the system files from 
the Cornerstone system diskette. You can leave your data 
files intact. To copy the Cornerstone system files to the 
\.CORNER directory, insert the Cornerstone system 
diskette in drive A and issue the DOS command 


C) COPY A:%*.% N\.CORNER 


Next, remove the Cornerstone system diskette and insert 
the Sample Database diskette in drive A, and issue the DOS 
commands 

C) COPY A:*.* \.CORNER 

C)DEL \CORNER\ «DBF 





Copying 
System Files 
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Customizing 
Your Batch File 


When you run Cornerstone you issue the DOS command 
| CORNER. The CORNER command runs a batch file named 
CORNER. BAT. Ina two-diskette system, this file tells DOS 
| that the Cornerstone system diskette is in drive B and the 
data diskette is in drive A. Ina hard-disk system, you tell 
DOS what directory you want to use by typing the directory 


| name after the CORNER command. In both two-diskette 


and hard-disk systems, the CORNER.BAT file tells DOS to 
run the MME program, which actually runs Cornerstone. 


| You can edit CORNER. BAT to suit your needs. To 


look at CORNER. BAT issue the DOS command TYPE 

CORNER. BAT, or use EDLIN (the DOS line editor, which 
you can read about in your DOS manual). Any batch file you 
use to start Cornerstone must contain the MME command. 
You may follow the MME command with one or more of the 
following switches to customize the way Cornerstone works. 


/c and /h (color and highlight). These switches allow 
you to set the color of the Cornerstone display. The /c 
switch sets the background and foreground (character) 
colors for normal, unhighlighted text. Menus, help 
messages, and your records are displayed using normal 
text. The /h switch sets the background and 
foreground colors for highlighted portions of the 





screen, such as the status and error lines. Each switch 
takes two parameters: the first sets the background 
color, the second sets the foreground (character) color. 


Each parameter is a hexadecimal digit identifying a 
color: 
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White 
Gray 
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Light Green 
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Light Red 


Light Magenta 
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Numbers 8 (gray) through F (white) can be used for 


foreground (characters) only. 


Suppose, for example, that you want yellow characters 
on a green background for normal areas of the display, 


and light blue characters on a red background for 


highlighted areas. A batch file that runs Cornerstone 


in these colors would contain the command: 
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MME /c2Eh49 


with 2 for the green background, E for yellow 
foreground characters, 4 for the red background of a 
highlighted area, and 9 for the light blue characters in a 
highlighted area. 


/s (system). The /s switch tells DOS what path to 
follow to find the Cornerstone system files. You follow 
the /s switch with a path that tells DOS where your 
Cornerstone system files are. 


In a two-diskette system, you type the name of the 
drive that you want to use for your Cornerstone 
system diskette. 


MME /sB: A: 

In a hard-disk system, specify a path to the 
Cornerstone system files from the root directory. For 
example, if your Cornerstone files reside in a 
subdirectory of a directory called “ACCOUNTS,” your 
batch file should look like this: 


MME /s\ ACCOUNTS\.CORNER . . . 


Because the batch file tells MME where to find the 
Cornerstone system files, you need only type the 
name of the batch file to run Cornerstone, no matter 
what directory happens to be the current one. 
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/w (wait). If you installed Cornerstone on a two- 
diskette system, two non-data files were copied onto 
your NEWDB data diskette: COMMAND.COM and 
MME.EXE. These files need not reside on your data 
diskette, where they occupy space you may want for 
your data files. By including a /w switch in your 
CORNER. BAT file, you can start up Cornerstone with 
a diskette in drive A that contains only the MME.EXE 
and COMMAND.COM files. The /w switch tells DOS 
to pause after it loads MME. EXE and 
COMMAND.COM so you can insert your data 
diskette. The CORNER. BAT in this case would be: 


MME /sB: /w A: 


/u (use). The /u switch limits the amount of memory 
Cornerstone is allowed to use. (Cornerstone normally 
uses as much memory as it can get.) For example, 
MME /u256 restricts Cornerstone to 256K bytes of 
memory. 


/e (extension). The /e switch allows your data files to 
have extensions other than DBF. This permits you to 
have two databases on one diskette. For example, if 
you have a database for personal use and one for 
business use, you can store them on the same diskette 
by giving the files for the personal database the 
extension PER and the files for your business database 
the extension BUS. You then write a batch file for each 
database. PERSONAL. BAT would contain: 


MME /ePER /sB: A: 
BUSINESS. BAT would contain: 


MME /eBUS /sB: A: 
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Moving 
Cornerstone to 
a Second 
Computer 





To run Cornerstone with your personal database files, 
you would enter: 


A) PERSONAL 


To run Cornerstone with your business database files, 
you would enter: 


A) BUSINESS 
To avoid confusion, don’t use an extension that has a 
special meaning to DOS (such as . BAT, .EXE, .COM), 
to Cornerstone (such as .CNR), or to other software 
products you may have. 


You can remove Cornerstone from your hard-disk system to 
install it on a second hard-disk computer by running the 
REMOVE program. Remove the write-protect sticker from 
the Cornerstone system diskette you used your first 
installation, insert the diskette in the drive A, and issue the 
DOS commands: 

C)CD \CORNER 

C) REMOVE 


You can now use the Cornerstone system diskette to install 
Cornerstone on a second hard-disk computer. Just follow the 
directions in “Read This First.” 


If you want to use Cornerstone on the computer where you 
originally installed it, remove the write-protect sticker from 
the Cornerstone system diskette, insert the diskette in 
drive A where you last installed Cornerstone, and issue the 
DOS commands: 


C)CD \.CORNER 
C) REMOVE 
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Next, remove the Cornerstone system diskette, insert it in 
drive A of the hard-disk computer you want to use, and 
issue the DOS commands: 


C)CD \.CORNER 
C) INSTALL 


Repeat this procedure whenever you want to use 
Cornerstone on your other hard-disk system. 


If your other computer is a two-diskette system, don’t use 
REMOVE and INSTALL. Just use the Cornerstone system 
diskette in drive B of the two-diskette system. 


When you use the Sample Database in the print-based 
lessons of the Beginner's Guide, you will actually modify the 
contents of the Sample Database files. If you are starting on 
the tutorial after another user, you will need to start witha 
fresh copy of these files. (Each user needs a clean slate, 
otherwise the information you are asked to enter will 
already appear in a file.) If you haven't followed the 

lessons In sequence, Cornerstone’s responses may not 
correspond to what is printed in the Beginner's Guide. 

To get a fresh copy of the Sample Database files in the 
\.CORNER\. SAMPLE subdirectory, insert the Sample 
Database Copy diskette in drive A and issue the DOS 
command: 


C)COPY A:*.DBF \.CCORNER\ SAMPLE 
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Saving Space 


| 


| Two-Diskette System 
Normally your data diskette also contains some non-data 
| files that need not reside there, such as the DOS system 
files; the batch file to run Cornerstone, CORNER. BAT; and 
_ the program that runs Cornerstone, MME.EXE. These 
three files take up about 120K bytes of diskette space, but 
_ you can copy them to their own diskette. First, format a 
blank diskette with the command: 


A) FORMAT B: 


Next, insert your data diskette in drive A, the formatted 
blank diskette in drive B, and issue the commands: 

A) COPY MME.EXE B: 

A) COPY CORNER.BAT B: 


Now format another blank diskette with the command: 
A) FORMAT B: 
Insert the blank diskette in drive B and enter the 


commands: 


A)COPY «.DBF B: 
A) COPY MS000255.CNR B: 





A) COPY FS«.CNR B: 
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This copies the data files, Help file, and Cornerstone form 
files only. Your new data diskette can now use the space 
once taken up by the MME. EXE and CORNER. BAT files, 
and by the DOS operating system files. 


Before you can use Cornerstone with this new set-up, you 
must edit CORNER. BAT so it does not look for the data 
files on the new diskette (which contains only MME. EXE, 
CORNER. BAT, and the operating system). Add the /w 
switch to the batch file: 


MME /sB: /w A: 


The Av switch tells the system to pause after it loads the the 
non-data files so you can remove that diskette and insert the 
data diskette. (See the section Customizing Your Batch File, 
above. ) 


The Help file, MS000255.CNR, contains the messages that 
are displayed when you press the (HELP) key. To get Help 
messages, this file must reside on your data diskette. You 
can delete it to gain more diskette space as long as you are 
willing to use Cornerstone without on-line help. To delete 
the Help file from your data diskette, insert the data diskette 
in drive A and enter the command: 


A) DEL MS000255.CNR 
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High-density diskettes 

If you use high-density diskettes (800-kilobyte or 1.2- 
| megabyte, for example) on your two-diskette system, you 
may copy all the Cornerstone system files, including the 
‘Help file, onto one diskette, leaving your data diskette free 
for storing nothing but your data and the DOS command 
processor, COMMAND.COM. To use this setup, label a 
new high-density diskette “High-density Cornerstone” and 
insert it in drive B. Insert the DOS diskette in drive A and 
issue the command 


A) FORMAT B: 





Next, insert your data diskette in drive A and enter the DOS 
commands 

A) COPY MME.EXE B: 

A) COPY CORNER.BAT B: 

A)COPY «.CNR B: 


You can now delete these files from the data diskette, but 
you will recover more diskette space if you copy the 
database files onto a new diskette. Your current data 
diskette contains some DOS system files that take up about 
22K bytes, but which cannot be deleted. Insert the DOS 
diskette in drive A, and a new diskette in drive B, then issue 
the DOS command 


A) FORMAT B: 
Remove the DOS diskette from drive A and replace it with 
your data diskette. Issue the commands 

A)COPY x.DBF B: 

A) COPY COMMAND.COM B: 


Remove the diskette from drive B and label it “Data Only.” 
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——~ Next, insert the Cornerstone system diskette in drive A, 
4 and the diskette you labeled “High-density Cornerstone” in 
drive B. Issue the DOS command 


oe A) COPY x.« B: 

r Finally, you must edit the CORNER. BAT file on your “High- 
“a density Cornerstone” diskette so it can handle the changes 
= you have made. Leave the “High-density Cornerstone” 

diskette in drive B, but replace the diskette in drive A with 
= —¥j your DOS diskette. Use EDLIN (the DOS editor described 
a in your DOS manual) to change CORNER. BAT to 
MME /w /s. A: 


When you run Cornerstone with this setup, insert your 


[ “High-density Cornerstone” diskette in drive B and the 
= Li (original, low-density) Cornerstone system diskette in 
r drive A. Enter the commands 
= A)B: 
L a! 
el B) CORNER 
=e FR After a few seconds the system will pause and ask you to 
— remove the Cornerstone system diskette from drive A and 
insert your high-density data diskette, then press any 
<= a character to start Cornerstone. 
i ont Hard-Disk Systems 
pret. —# Once you have installed Cornerstone, you may delete 
ee SETUPHD.BAT, the batch file which runs the installation 
-— ona hard-disk system. Enter the DOS command 
— ®t C)DEL \.CORNER\ SETUPHD.BAT 
be You may also delete SETUP. OUT, which lists the 
i = directories that were made and the files that were copied 


—a during installation. Because the information it contains may 


202  Reinstallation and Saving Space 






prove helpful if you have to call the hot line about installation 
problems, make a printout of the file before you delete it. To 
delete SETUP. OUT, enter the DOS command 


C)DEL \(CORNER\ SETUP. OUT 


You can delete the files associated with the computer-based 
portions of the Beginner’s Guide, which use about 500K 
bytes of disk space. To delete these files (which you can 
always copy again later), issue the commands: 


C)CD \.CORNER 
C) DELBEG 


You can recover about 110K bytes of disk space by deleting 
the Help file, MS000255.CNR. You will no longer get any 
help messages when you press (HELP), of course, but you 
can always copy the file later if you need it. To delete the 
Help file, issue the command: 


C) DEL \.CORNER\.MS000255.CNR 


| Ifyou have deleted many records in a Cornerstone file, you 
should use the Backup utility. In the process of backing up 
your files, this utility reclaims the space taken up by deleted 
records. See chapter 3, “The Backup Utility.” 
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Crash Recovery Procedures 


Certain events or circumstances can cause Cornerstone to 
act unusually or even crash. This chapter describes what 
these are and how to recover from their effects. 


If you happen to be reading this chapter before you need to, 
learn this lesson now: «= back up your files regularly with 
Cornerstone’s Backup utility. = 


Power Failure 

If the power supply to your computer is interrupted while 
using Cornerstone (for example, by a power failure or by 
pulling out the power cord), you may lose some of your data. 
This is especially likely if you are in Update mode or Define 
mode when the power failure occurs. When power is 
restored to your computer, follow the instructions in the 
What To Do section below. 


Disk Errors 

If Cornerstone crashes and you get a DOS error message 
like “Unrecoverable read error” or “Unrecoverable write 
error,” some data may be lost. These errors should not go 
unheeded, as they usually indicate failures of the disk drive, 
the disk controller, or the recording surface of the disk. If 
using a new diskette doesn’t help, you should have your 
hardware serviced before trying anything in the What To Do 
section below. 
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Start-Up Problems 
| Start-up problems are often caused by a simple misspelling 
or an improper path specification, and do not cause data to 
| be lost. Here are the error messages and solutions: 


} 








The data directory xyz does not exist. You either 
typed the name of the directory wrong, or you don't 
have a directory called xyz. 


Couldn’t read file: CORNER.MME. Be sure you 
are connected to the directory that contains the 
Cornerstone system files (\.;CORNER). 


The system cannot find the file called 
MS000000.DBEF ... You tried to use Cornerstone 
with a directory or diskette that doesn’t have any data. 
Another possibility is that the database files in the data 
diskette or directory you specified do not have the file 
extension that the CORNER. BAT file is looking for. 
Make sure you are using the correct diskette or 
directory name, and check that the extension of the 
database files matches the one specified with the /e 
switch in the CORNER. BAT file. 


The data disk is nearly full ... This is a warning, 
not an error message. You have less than 4K bytes of 
space left on your data diskette. Delete records you no 
longer need (in Update mode), then use the Backup 
utility to regain some space. 
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Abnormal Exits 

When you issue the EXIT command in Initial mode, 
Cornerstone makes sure your database is consistent. If 
everything is okay, you'll see the DOS prompt (A) or C) ). 


If certain error conditions exist, you will see more than the 
DOS prompt when you exit Cornerstone. In fact, 
Cornerstone may terminate itself in these cases, before you 
even have a chance to issue the EXIT command. Here are the 
possible error messages, what causes them, and what you 
should do about them: 


Disk full. There was not enough room on the disk to 
write new records or other new information. 
Cornerstone attempts to free some reserved space 
and write out the database. Start up Cornerstone again 
and delete any records you don’t need, then use the 
Backup utility to regain the disk space. 


Stack memory space exhausted or Data memory 
space exhausted. The system ran out of memory, 
but your records may have been saved. This is most 
likely to happen when you display or print a form (filled 
with data) that is very large (about 300 lines or 20 
screens per record). For example, an unusually large 
number of subrecords in a form may cause this 
problem. Follow the instructions in the What To Do 
section below. 
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Abort requested, files have been closed. This is 
not an error message but a confirmation that you 
pressed Ctrl-Break to abort a sorting or printing, for 
example. No records are lost. 


Abort Requested. WARNING: The database may 
not be consistent. You pressed Ctrl-Break to abort, 
but there were so many disk errors that some records 
may be lost. Follow the instructions in What To Do, 
below. 


In other cases the message “Exit value: , module: 7” may 
appear. These are less likely to occur, but you should record 
them, and try to record what you did that led to the 
message, so you can provide the information if you call the 
hot line. 


No Activity 

If you have entered a command, but the drive lights don’t 
blink for a while, be patient. If you wait for more than ten 
minutes, though, something is probably wrong. Press 
Ctrl-Break to abort the current operation, and wait a few 
seconds. If nothing happens, press Ctrl, Alt, and Del at the 
same time to reboot the system. If the system doesn’t 
reboot, turn off your computer, wait 15 seconds, then turn it 
back on. Next, read the following section, What to Do. 
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Use CHKDSK | What to Do 
The first step is to issue the DOS command CHKDSK to 
check the disk structures used by DOS and rebuild them if 
necessary. Omitting this procedure will waste space on your 
disk, and may cause subtle but widespread damage. 
However, if you have at any time encountered an 
unrecoverable disk error (such as “Unrecoverable write 
error” or “Unrecoverable read error”), don’t use CHKDSK. 
Such an error usually indicates a hardware problem which 
CHKDSK would aggravate. In this case continue to the 
section Use Backup, below. 


To check a data diskette, insert the DOS diskette in drive A 
and your data diskette in drive B, then enter the command 


A)CHKDSK B: /F 
To check a hard disk, enter the DOS command 
C) CHKDSK /F 


If CHKDSK encounters inconsistencies, it will give the 
message 

n lost clusters found in m chains. 

Convert lost chains to files (Y/N)? 


The message means CHKDSK has found » clusters of data 
marked as allocated but not associated with a file. The 
clusters may contain lost data. CHKDSK asks if you want to 
assign these to clusters to files. Since any data in these 
clusters are no longer usable, there is no reason to assign 
them to files. Answer “N” and press (ENTER). CHKDSK 
frees the clusters so they can be allocated to new files, then 
reports how much disk space is free for use. 
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| If you get any other error message from CHKDSK, make a 
note of it and call the hot line (the number is on your 
_ Customer Assurance Program booklet). 


| Use Backup 

| If CHKDSK gives you no error message other than the one 
| mentioned above, the next step is to use the Backup utility 
to back up your data files. Make sure you back up to an 
empty diskette or directory. Chapter 3 explains how to use 
the Backup utility. 


If, while using Backup mode, you get an error message of 
the form “Exit value: 7, module m”, or if there is no disk 

| activity for more than ten minutes, note down this 

| information and call the hot line. 





Run Cornerstone 

If the backup reports that a number of records were 
damaged (in effect, lost) and not backed up, restore the 
backup files to your database immediately to remove the 
damaged records from the database and prevent them from 
doing any harm. Next, try using Cornerstone. 





If the backup succeeds and reports no damaged records, 
your database files are probably intact. You may continue 
working with existing data without having to restore the 
backup files. If the system crashes or acts unusually, 
however, restore the backup files you just made and try 
using them. 


If you have tried all the steps above and Cornerstone still 
acts unusually, call the hot line (the number is on your 
Customer Assurance Program booklet). 
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CHAPTER 12 


Glossary 


_ We have tried to avoid using jargon and special terms in 
| Cornerstone and its documentation. We don’t want to 


impede your learning by using words that are unfamiliar, but 
we realize we use some words in special ways. This 
glossary lists some terms whose meanings may not be 
obvious. Some of them are common to the world of 
computing (file, record, field), while others are special to 


| Cornerstone (attribute, completion, View mode). The index 


_ A bold italic word or phrase in an entry for this glossary 
indicates a related entry. 








will point you to sections of the documentation that provide 
more information about a term than is provided here. 
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Abort 


AFTER 


Aggregate expression 


Arithmetic expression 


Arrow keys 


Ascending 


Attribute 


Attribute 
characteristic 


Attribute name 
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To halt a Cornerstone process (such as sorting, selecting, or printing) 
while Cornerstone is running, press Ctrl-Break to stop Cornerstone. 
For some operations, such as sorting, aborting will cause the system 
to exit Cornerstone and return to DOS, 


When used in selection forms, the expression AFTER x selects values 
greater than x. For example, AFTER 1/1/84 selects values after 
1/1/84. See BEFORE, Range selection. 


Any expression that contains an aggregate function. Examples 

of aggregate expressions are: SUM(Total_Purchases) and 
MAX(Order_Date). An aggregate function is used to compute a single 
value from a set of values of a particular attribute. Chapter 6, 
“Entering Information Into Forms,” in Owner's Handbook I describes 
the aggregate functions. 


Any expression containing the arithmetic symbols + (addition), 
— (subtraction), « (multiplication), / (division), “ (exponentation) 


The arrow keys (ARROW-LEFT), (ARROW-RIGHT), (ARROW-UP), and 
(ARROW-DOWN) are used throughout Cornerstone. You can use them to 
select options from the command menu, or, in Edit and Format modes, 
to move the cursor about the form. 


A sort in ascending order arranges values in alphabetic order (A to Z) 
or from lowest to highest (0 to 100, 1/1/37 to 12/31/87, and so on). See 
Descending. 


Attributes describe the basic pieces of information that are stored in 
the records in a file. For example, a file called People might have 
attributes Name, Address, and Phone Number. Each attribute has its 
own attribute characteristics (which you select), that describe the 
attribute in detail. In Cornerstone, attributes are distinguished from 
fields, which appear in forms. Fields are used to display attribute 
values or other information. An attribute corresponds to what many 
other database systems call a field. 


The characteristics you give an attribute describe the attribute to 
Cornerstone. Some examples of attribute characteristics are the 
attribute’s name, its type, and whether or not it is mandatory. 
Attribute characteristics determine what you can enter as a value for 
the attribute, how its values are displayed, and how you can use the 
attribute. You can modify the characteristics of an attribute in Define 
mode. See Field characteristic. 


The name you give an attribute. You can give an attribute almost any 
name you please, subject to minor restrictions. For example, you can’t 
give two attributes the same name, nor can you give an attribute a 
name that’s the name of a ft/e in your database. 
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Automatic selection 


(BACKSPACE) 


Backup utility 


BEFORE 


Boolean 


Bottom status line 


(CANCEL) 


Column format 


(COMMAND) 


Command cursor 


Command key 


Command level 


Whenever Cornerstone selects records (using selection criteria), the 
process is called automatic selection. This is opposed to Manual 
selection, when you manually select records by flagging them. 


This kev erases the character to the left of the cursor 


With the Backup utility you can make copies of your database to protect 
it against loss or damage. You can also use the Backup utility to 
compress the files in your database, making them more storage- 
efficient. 


When used in a selection form, the expression BEFORE x selects 
values less than x. For example, BEFORE 3:30 AM selects values 
before 3:30 AM. See AFTER, Range selection. 


One of the data types an attribute can have is Boolean. A boolean 
attribute can only have one of two values: Yes or No. A boolean 
attribute is similar to an enumerated attribute. See Data type, 
Enumerated. 


The bottom status line lies below the data area at the bottom of the 
screen when status history is not displayed. It usually contains the 
name of the current file, the previous mode, and the number of files 
viewed. See Level of interaction, Top status line, Status history. 


The (CANCEL) key erases the entire command line when you are 
entering a command. It’s also sometimes used to cancel an operation 
or aS a command (in Edit mode). 


A report format in which selected attributes are displayed in columns 
across the screen, with the attribute names appearing above the 
columns. The COLUMN command in View mode lets you create a column 
format. 


In Edit or Format mode, you must first press the (COMMAND) key to 
issue commands from the menu. 


When Cornerstone is waiting for you to enter a command, it displays a 
prompt and positions the cursor on the command line. The cursor in 
this context is called the command cursor. 


Certain Cornerstone commands (such as (DONE)) are issued by 
pressing a particular key, called a command key, ( Throughout the 
documentation, command keys are enclosed in angle brackets. ) 


Cornerstone is at command level whenever it is waiting for you to enter 
a command. Cornerstone indicates this by positioning the cursor on 


the command line and displaying a prompt informing you what it 
expects next. 
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The command line is a line near the top of the screen (below the error 
line) that Cornerstone uses to display commands as you enter them 
When you press (ENTER) to execute the command, Cornerstone 
displays the symbol [ok] to indicate that it has accepted your command 
and is executing it. When Cornerstone finishes executing the 
command, it erases the command line and waits for you to issue 
another command, 


When you make backup copies of your database, Cornerstone 
compresses your files by eliminating records that have been deleted 
(such records continue to occupy space in your files until you create a 
backup and restore it). This process is called compaction. The 
REORGANIZE command (in Backup mode) further compresses your files. 


When entering a Cornerstone command you need only type enough 
characters to identify uniquely one of the choices in the menu; if you 
then press (SPACE), Cornerstone completes what you have typed and 
waits for you to enter the next command option. When entering 
selection, derivation, initial value, and cross-file range constraint 
expressions in a form, Cornerstone also automatically completes your 
entry if you have entered enough characters to make your entry 
unambiguous. 


In Format mode, you can type text directly in the form. Such text is 
called constant text because it is part of the form, and so does not 
change from record to record the way the values of a field do. You can 
use constant text for headers, titles, comments, instructions for filling 
out the form, or decorative elements such as borders or dividers. 


When you define (or redefine) an attribute in Define mode, you can 
specify certain constraints that data entered for the attribute must 
satisfy. For example, you can specify that the attribute be mandatory 
or that it have unique values. There are other kinds of constraints as 
well. Whenever you enter information into a record, Cornerstone 
checks to see that the information you have entered satisfies all the 
constraints that apply. Cornerstone will not permit you to enter any 
information that violates one of the constraints. 


You can issue certain Cornerstone commands quickly by entering a 
control-key sequence. To issue such a command in this way, you must 
hold down the Ctrl key while pressing another key. 


The Convert utility allows you to convert Cornerstone files to files that 
can be used with other software products, and vice versa. 


This is one of the attribute characteristics you can supply when you 
define or redefine an attribute in Define mode. If you want to limit the 
values of an attribute in one file to be one of the values for an attribute 
in another file, you can define a cross-file range constraint. 
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Define mode 
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The CUSTOMIZE command in Initial mode allows you to customuze 
various overall properties of the system, such as the menu W indow 

size, the default type-in style, or whether status history 1s displayed 
You can also customize your conversion in Convert mode. See Menu 


window, Status history. 


The data area is the largest portion of the display, occupying most of 
the screen. Cornerstone uses the data area to display different 
information for you to work with, depending on what mode it’s in. 


When you define an attribute in one of your database files, you must 
tell Cornerstone what kind of data you plan to enter for the attribute. 
You do this by selecting one of the data types that Cornerstone allows: 
String, Number, Integer, Date, Time, Boolean, or Enumerated. 
(You can also select Derived or Subrecord, but these are not 
primitive data types—see Primitive attribute.) The type of an 
attribute determines what you can enter as a value for the attribute, 
how its values are displayed, and how you can use the attribute. For 
example, you can SUM Numbers, but not Strings. 


The most general definition of a database is any system—paper, 
electronic, or otherwise—that is used to store and organize 
information. A Cornerstone database is a collection of files that 
Cornerstone uses to store and manage information. See Attribute, 
File, Record, Relationship. 


One of the data types an attribute can have is Date. An attribute of type 
Date has values that are dates, such as 1/7/86 or October 9, 1959. 


Cornerstone provides default choices in many situations. A default 
choice or value is simply one that Cornerstone uses if you don’t 
explicitly tell it otherwise 


In Define mode, you can modify the structure of your database. You can 
create, delete and change both files and attributes; you can define 
and remove relationships; and you can modify attribute 
characteristics. The DEFINE command in Initial mode puts the 
system in Define mode. See Top level, File level, Subfile level. 


The database definition is simply a description of the files and 
attributes in your database, and of the relationships between them. 
This definition is implicit in the way you define your database. You can 
print your database definition using the PRINT command in Define 
mode. 


A derivation expression is an expression, or formula, that tells 
Cornerstone how to compute the value for a Derived attribute. 
Cornerstone has several types of derivation expressions, such as 
mapping expressions, arithmetic expressions, aggregate 
expressions, functions, and constants. A derivation expression can 
contain combinations of these. See chapter 6, “Entering Information 
Into Forms” in Owner's Handbook IT. 
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A derived attribute is one whose value is computed from other 
information in your database. See Attribute type, Derivation 
expression, Formula, Mapping expression. 


A sort in descending order arranges values in reverse alphabetic order 
(Z to A), or from highest to lowest (100 to 0, 12/31/84 to 1/1/37, and so 
on). See Ascending. 


When you use the Convert utility, the file that receives the converted 
data is called the destination file. The destination file can be either a 
Cornerstone file or a foreign file. See Source file. 


A detailed format shows selected attributes from a file, arranged so 
that each attribute appears on a separate line. A detailed format may 
contain fields for all the attributes ina file, or for only some of them. To 
create a detailed format, issue the DETAILED command, which is 
available in View, Update, Select, and Format modes. 


A device (also print device) is actually a printer or any other such 
apparatus, but in Cornerstone, the term refers to the information that 
describes this printer or apparatus. The device definition (which can 
be altered in Print mode) supplies Cornerstone with important 
information about the printer you plan to use, such as what 
character(s) it expects for a line feed or form feed. 


See Arrow keys. 


Certain attribute and field characteristics (such as Display commas? 
and Display style for date) are used to control the way Cornerstone 
displays information. These characteristics are collectively called 
display characteristics. 


Pressing the (DONE) key tells Cornerstone that you are finished with a 
particular operation, and wish to return to what you were last doing. In 
general, it’s used to leave the current mode and return to the previous 
one. 


Whenever you are filling out a form, the system is in Edit mode. In 
Edit mode, you type text into a form. Depending on the form, the 
values you type can be data for one of your files, selection criteria, or 
instructions to the system concerning customization, formats, printing 
characteristics, or attribute definitions. 


When entered in a selection form, EMPTY selects records that do not 
have a value for that attribute. See NOT, Non-empty match. 


One of the data types an attribute can have is Enumerated. An 
enumerated attribute can only have one of a set of values (such as Red, 
White, or Blue). The values the attribute can have are called 
enumerated values, and you specify them when you define the 
attribute in Define mode. See Data type. 
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Enumerated values The set of values an Enumerated attribute can have. See 
Enumerated. 
Error message Anytime Cornerstone cannot do what you ask, for whatever reason, |! 


displays an error message on the error line. The message describes 
the problem and sometimes suggests a course of action. If you are 
uncertain what to do next, you can press the (HELP) key to get more 
information about the error. 


Error line The error line is the top line of the screen. Cornerstone uses this line 
to display error messages. 


Exact match If you enter a data value into a selection form, Cornerstone will select 
records that have that value. This is called exact match selection. 


EXCLUSIVE EXCLUSIVE is used in range selection expressions to exclude the 
endpoints of the range. For example, “50... 100 EXCLUSIVE” asks 
Cornerstone to select records having values between 50 and 100, but 
not ones that have a value of exactly 50 or exactly 100. See Range 
selection, AFTER, BEFORE, GT, LT. 


Export When you use the Convert utility to convert from Cornerstone to 
another format, you exporf; when you convert from a foreign format to 
Cornerstone, you import. 


Field A field is a slot in a form that is used to enter or display data. Generally, 
a field corresponds to some attribute, whose value fills the field, but 
this 1s not always the case (for example, fields in subtotal forms contain 
aggregate information rather than the value of some attribute). For this 
reason, Cornerstone distinguishes between attributes and fields. A 
field consists of a field name and an area where values can be entered 
or displayed. In Format mode, you can place fields anywhere in the 
form. 


Field characteristic Fields in a form have certain characteristics, such as a name and width. 
You can set the characteristics of fields in Format mode by issuing the 
SET-CHARAC command. Some characteristics, such as the name and the 
display characteristics, are attribute characteristics as well as field 
characteristics. For these, the Cornerstone obtains the default value 
for the field from the corresponding attribute (if there is one). You can 
then change them for particular forms. Changing field characteristics 
does not affect attribute characteristics. 


Field cursor In Edit mode, the field cursor indicates the current field, which is the 
one you can enter a value for. 


Field delimiter When you convert files to or from certain foreign file formats, you may 


have to specify a character or characters that the foreign format uses to 
separate the values of different fields in a record. 


Field name One of the characteristics of a field ina form is its name. You can 
change the name of a field in Format mode. 
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A Cornerstone file is a collection of records which contain 
information. A database is made up of a bunch of files. For example, 
the Sample Database is made up of a Customer file, an Order file, and a 
Part file. Each record in a Cornerstone file contains information about 
a particular entity, such as a customer, an order, or a part. The 
information in Cornerstone files is actually stored in several DOS files 
on your diskette or hard disk. The data in your files, the descriptions of 
your database, the formats and selection criteria you save, the indexes 
you have specified for attributes, and even the help messages, are all 
kept in different DOS files. These DOS files have names (such as 
FS001000. DBF) that are unrelated to the names of your Cornerstone 
files (such as Customer). Chapter 13, “Cornerstone Technical Data,” in 
Owner’s Handbook IT, describes the naming conventions Cornerstone 
uses, and explains what each DOS file is used for. 


Define mode, the mode that provides commands to manipulate the 
structure of your database, is divided into three levels: Top, File, and 
Subfile. At File level, commands are provided to create and modify the 
attributes ina particular file. See Top level, Subfile level. 


Every Cornerstone data file has aname. You give a file its name when 
you define (or redefine) it in Define mode 


The precise action of the (FIRST) key 1s different for each mode, but it 
generally moves the cursor to the first element of a set you are 
working with, making that element the current one. See Cursor. 


In View mode, the (FLAG/UNFLAG) key flags a record if it is not already 
flagged, and unflags a record if it 1s. 


In View mode, a record is flagged if it bears an F next to it in the left 
margin. Certain Cornerstone commands work with flagged records. 
Flagging records is a way to manually select records you are interested 
in. See (FLAG/UNFLAG), Manual selection. 


When converting Cornerstone files to or from files that can be used 
with other software products (such as PFS: File and dBase II), the 
latter files are called foreign files. Any file that is not a Cornerstone file 
is a foreign file. 


Cornerstone uses forms to display information in the database. In Edit 
mode, you can enter information into a form. Forms are made up of 
fields, which are slots in which you enter information. Cornerstone 
has many forms you can fill out, and you fill out a form any time you 
add (or change) a record. You can use Format mode to design your own 
forms. 


A format determines how data is arranged for the purposes of viewing 
or printing. In View mode, you can design a report format, which 
includes one or more report elements. In Update mode, you can 
format update forms, and in Select mode, you can format selection 
forms. See Report format. 
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In Format mode, you can design your own forms. You can move [eld 


around, add and delete lines, and type text into the form. Basi ally, 
you can make a form appear however you like. You can get to Format 
mode from View, Update, Select, and Print modes 


A derived attribute is sometimes called a formula; these terms refer to 
the same thing. You can use the CALCULATE command (in View, Select, 
and Format modes) to create a new formula or change an existing one, 
without entering Define mode. This is useful when you want to 
compute derived information to include in a report or form without 
interrupting what you are doing. If you create a new formula (derived 
attribute) using CALCULATE, it remains a part of your database 
definition until you explicitly delete it (in Define mode). 


Original creator of the Sample Database, Fred is the Cornerstone user 
par excellence. Fred runs an auto parts business called Omnifex and 
drives a'71 Plymouth Duster. 


Cornerstone provides various commonly used mathematical, 
statistical, and financial functions, such as SQRT (SQuare RooT) and 
PV (Present Value) that can be used in derivation and initial value 
expressions. They are listed in chapter 6, “Entering Information Into 
Forms,” in Owner's Handbook II. 


“Greater than or Equal to.” This symbol is used in range selection 
expressions to select records having values greater than or equal to 
some value. GE x selects records having values greater than or equal 
tox. See LE, LT, GT, AFTER, EXCLUSIVE, Range selection. 


In Format mode, you can print a grid on a pre-printed form. This is 
simply a pattern that numbers the lines and columns in the form. The 
grid makes it easier to design Cornerstone forms that match pre- 
printed forms. You can then print information in your database onto the 
pre-printed forms. 


The grouping attribute is the attribute that determines the groups for 
which Cornerstone computes subtotals whenever you issue the REPORT 
SUBTOTAL command in View mode. For example, if you compute 
subtotals by city, the grouping attribute is City. 


ia 


“Greater Than.” This symbol is used in range selection expressions to 
select records having values greater than some value. GT x selects 
records having values greater than x. GT is the same as AFTER. See 
GE, LE, LT, AFTER, EXCLUSIVE, Range selection. 


One of the report elements a Cornerstone report format can have 
is a header. When you issue the COLUMN command in View mode, 
Cornerstone automatically creates a report header containing the 
names of the attributes you include in the report. You can modify the 
header in Format mode, and you can even include in it total information 
such as is computed using the REPORT TOTAL command in View mode. 
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All of the help messages for Cornerstone are contained in this disk file 
You can delete this file to save disk space without harming the system. 
(You will then, of course, not receive any help when you press the 
(HELP) key.) The DOS name of this file 1s MS000255. CNR. 


You can press (HELP) any time the system 1s waiting for you to do 
something; Cornerstone will display a message telling you where you 
are in the system, and what you can do next. If you press (HELP) after 
receiving an error message, Cornerstone will describe the problem in 
more detail and suggest corrective courses of action. Sometimes you 
can press (HELP) several times to get additional information. You can 
also get assistance by pressing the (OPTIONS) key. 


With the REPORT HIDE command in View mode, you can hide (suppress 
the display of) any of the report elements (header, records, subtotals, 
or totals). See Showing report elements. 


See (WINDOW-LEFT), (WINDOW-RIGHT). 


n (1955) (1) a direct telephone line in constant operational readiness so 
as to facilitate immediate communication (as between heads of two 
governments); (2) a telephone service by which usually unidentified 
callers can talk confidentially about personal problems to a sympathetic 
listener; (3) 617-576-3190. 


You import when you convert from a foreign format to Cornerstone, 
using the Convert utility. See Export. 


Cornerstone uses an index to locate records in your database, just the 
way you would use the index ina book to locate the page containing a 
particular reference. Indexes are kept for individual attributes in your 
database. You tell Cornerstone which attributes to index by filling out 
the attribute definition form in Define mode. The purpose of an index 
is to make certain operations, such as sorting and selection, operate 
more quickly than they would without an index. 


The starting mode of Cornerstone. You must return to Initial mode 
before you can exit the system. 


When you enter View mode, the records that initially constitute the 
working set are the initial set. The initial set contains all the records in 
the file, except when you use the ONLY-RELATED-RECORDS option to 
view records that are related to one or more records ina file. Whenever 
you perform a selection, records are selected from the initial set. See 
Working set. 

A value that Cornerstone automatically enters for an attribute 
whenever you create a record, When you define an attribute, you can 
give it an iitial value expression. Cornerstone uses this expression to 
compute the initial value for the attribute. Initial value expressions 
have the same syntax as derivation expressions. 
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INS 


(INS/OVS) 


Insert type-in style 


Integer 


(LAST) 


LE 


Level of interaction 


Literal 


LT 


Mandatory 


(INSert) This symbol is used in the Edit and Format mode status lines 
to indicate that the current type-in style is msert. See Insert type-in 
style, OVS. 

The (INs/ovs) key is used to switch between Insert and Overstrike 
type-in styles in Edit and Format modes. See Insert type-in style, 
Overstrike type-in style. 


In this style, the characters typed into the system are inserted at the 


cursor location, shifting any text to the right one character. 5ee 
Overstrike type-in style. 


One of the data types an attribute can have Is Integer. An integer 
attribute has values that are integers (such as 1, 234, or -89). See 
Data type, Number. 


The precise action of the (Last) key is different for each mode, but it 
generally moves the cursor to the last element of a set you are working 
with, making that element the current one. See Cursor. 


“Less than or Equal to.” This symbol is used in range selection 
expressions to select records having values less than or equal to some 
value. LE x selects records having values less than or equal to x. See 


GE, GT, LT, BEFORE, EXCLUSIVE, Range selection. 


Anytime you view a file, you create a new level of interaction. For 
example, if you are viewing the Customer file, and then issue the 
command VIEW ORDER to view the order file (without first leaving View 
mode), you will then have two levels of interaction: the current one 
with the Order file, and the original one with the Customer file. When 
you press the (DONE) key you will return to viewing the Customer file. 


You can use the literal character, backslash (\.), in selection forms to 
tell Cornerstone to interpret what you type literally. For example, to 
select records containing the word “empty” in a Notes field, you can’t 
simply type EMPTY in the selection form, since Cornerstone 
interprets EMPTY to mean “records that don’t have a value.” Instead, 
enter “\.EMPTY”. The backslash relieves EMPTY (and any other 
special keyword) of its special meaning. Type a double backslash (\\\) 
to select values containing a backslash. 


“Less Than.” This symbol is used in range selection expressions to 
select records having values less than some value. LT x selects records 
having values less than x, LT is the same as BEFORE. See GE, GT, 
LT, BEFORE, EXCLUSIVE, Range selection. 


One of the characteristics an attribute can have Is that it be mandatory. 
This means that you must enter a value for the attribute whenever you 
create a new record in the file. You can make an attribute mandatory by 
entering “Yes” in the Mandatory? field of the attribute definition form 
in Define mode. 
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In View mode, you can select records manually by flagging them and 
then issuing either the SELECT FLAGGED or SELECT UNFLAGGED 
commands. This is distinguished from automatic selection, for 
which Cornerstone selects the records using selection criteria that you 
enter. See Flagged record. 


A mapping expression is a kind of derivation expression. A mapping 
expression is of the form File Attribute, where File is the name ofa file 
in your database and Attribute is the name of an attribute in that file. 
Mapping expressions allow you to include information from one file in 
another, related, file. 


The menu is in an area near the top of the screen, below the prompt 
line, that contains a list of options for you to choose from. These may 
be commands, command options, attribute names, file names, 
formats, or selection criteria. 


The menu cursor is a highlighted block in the menu window that rests 
on the current menu option, if any. To select the highlighted menu 
option, simply press (SPACE). You can move the menu cursor (i.e., 
choose other menu options) using the arrow keys: (ARROW-DOWN), 
(ARROW-LEFT), (ARROW-RIGHT), and (ARROW-UP). 


A menu option is any choice that appears in the menu window. It can be 
4 Cornerstone command or command option, a file or attribute name, 
or the name of a format or selection criteria. 


Sometimes, when entering a command, you may have more options 
than fit in the menu window. Cornerstone indicates this situation by 
displaying an ellipsis (...) at the beginning and/or end of the menu 
window. If you press one of the arrow keys 1n this situation, 
Cornerstone may scroll the menu in order to move the cursor to a 
menu option that lies outside the window. You can always press the 
(OPTIONS) key to see all the choices. 


The menu window is the portion of the screen used by Cornerstone to 
display the options available for you to choose from when you are 
entering a command. This window is normally two lines deep, but you 
can change the size of the menu window using the CUSTOMIZE 
command in Initial mode. Regardless of the size of the menu window, 
you can press the (OPTIONS) key to see all the choices in the menu. 


When Cornerstone is running, it is in one of ten modes. Each mode 
contains commands appropriate for a particular function. For example, 
in Define mode, you define your database; in Select mode, you specify 
criteria used to select records. See Define, Edit, Format, Initial, 
Print, Select, Update, and View modes. See also Backup utility, 
Convert utility. 
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Each mode displays information relevant to the mode on the Top 
status line (if status history is suppressed) or on its own status ling 
(if status history is displayed). The mode status line is sometimes 
simply called the status line. 


The motion keys—(NEXT), (PREVIOUS), (FIRST), and (LAST)—have 
different effects depending on what mode the system is in, but they 
generally move the cursor to the next, previous, first, or last element 
of a set, making that element the current one. See Cursor and each 
key. 


Cornerstone allows attributes to have more than one value, if you so 
define the attribute. Such attributes are called mu/ti-valued. You 
specify the maximum number of values an attribute can have when you 
define the attribute. See Single-valued attribute. 


In Select mode, you can use the NEGATE command to negate the 
criteria in a selection form. This causes Cornerstone to select records 
not meeting the criteria in the form. 


The precise action of the (NEXT) key is different for each mode, but it 
generally moves the cursor to the next element of a set that you are 
working with, making that element the current one. See Cursor. 


If you type an asterisk (x) into a field of a selection form, Cornerstone 
will select records that have some value for the corresponding 
attribute. It will not select records that have no value for the 
corresponding attribute. This is called a non-empty match. See 
EMPTY, Wild card. 


This symbol is used in selection forms to select records not meeting a 
particular criterion. If you enter NOT x ina selection form (where x 
can be any selection expression), Cornerstone will select only records 
not satisfying criterion x. 


One of the data types an attribute can have is Number. A number 
attribute can have any value that is a number, such as 1.9, -345, or 
2.71828. See Data type, Integer. 


This key lists the options currently available to you. If you press 
(OPTIONS) while entering a command, Cornerstone will display the 
entire menu, even it contains more options than fit in the menu 
window. If you press (OPTIONS) while filling out a form, Cornerstone 
will tell you what you can enter into the current field. If this field takes 
enumerated values or is subject to a cross-file range constraint, 
Cornerstone will list the values you can enter. 


In this style, characters typed into the system (when the cursor is on 
existing text) replace text that is already present. See Insert type-in 
style. 


(OVerStrike) This symbol is used in the Edit and Format mode status 


lines to indicate that the current type-in style is overstrike. See INS, 
Overstrike type-in style. 
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This key scrolls the contents of the data area (report, help message, 


and so on) backward one screenful. 


This key scrolls the contents of the data area (report, help message, 
and so on) forward one screenful. 


The precise action of the (PREVIOUs) key 1s different for each mode, but 
it generally moves the cursor to the previous element of a set that you 
are working with, making that element the current one. See Cursor. 


When a file contains subrecord attributes, it is sometimes called a 
parent file in order to distinguish it from its subfiles. 


A primitive attribute is an attribute into which you can enter values of a 
specific data type. Derived and Subrecord attributes are not 
primitive, since you cannot enter data directly as their values. For a 
discussion of the differences between derived and primitive attributes, 
see chapter 9, “Planning Your Database,” in ( Jwner’s Handbook I, and 
chapter 5, “Efficiency With Cornerstone,” in Owner's Handbook II 
See Attribute, Data type. 


See Device. 


In Print mode, you can specify how Cornerstone should print your 
report, and you can create and alter print devices. You enter Print 
mode from View mode with the PRINT SETUP command. 


The prompt line is the third line on the screen, just below the 
command line and above the menu window. Cornerstone uses this line 
to display prompt messages that tell you what Cornerstone expects you 
to enter next—for example, an attribute name or one of the options in 


the menu. 
See Cross-file range constraint. 


In Select mode, you can tell Cornerstone to select records whose 
values lie within a particular range. This kind of selection 1s called 
range selection. You indicate a range by typing an an ellipsis (...). For 
example, “1... 100” tells Cornerstone to select records whose values 
are between 1 and 100. Range expressions can be open-ended, as in 
“1...” and“... 100”. See EXCLUSIVE, AFTER, BEFORE, GE, 


GT, LE, LT. 


The Recompute utility allows you to recompute values for selected 
attributes ina file. It is described in detail in chapter 4, “The 
Recompute Utility,” in Owner's Handbook II. 


Records are the basic elements that make up a file. Each record ina 
file contains information about an individual entity, such as a customer 
or client. For example, each record in the Customer file in the Sample 
Database contains information about a particular customer. Each 
record ina file has the same structure, or attributes—such as Name, 


Street, City, and State. 
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| " > i indicating 
Record cursor In View mode. a highlighted bar to the left of a record indicat 
is the current record. At either end of this bar is anangle bracke 


that marks the beginning or end of the record 


imi ; or foreig » formats, you must 
Record delimiter When vou convert files to or from certain foreign file : 
specify the character or characters that the foreign format uses to 


separate records within the file 


Relationships A relationship is a link between two files that allows you to share 
information between the files using derivation and initial value 
expressions. You can start a relationship in Define mode. 


Report A report consists of particular information from your database, 
formatted in a particular way. You can print a report, or simply view 1t 
on the screen in View mode. A report can contain a header, records, 
subtotals, totals, anda title. A report may contain all, or some, of 
these report elements. You create reports in View mode, See 
Report format. 


Report element rhe elements that constitute a report are its header, records, 
subtotals, totals, and title. Any particular report may include all o1 
some of these elements 


Report format lhe report format determines how the information in a report 
appears. This includes the placement of fields, what report elements 
are included, how numbers, dates, and times are displayed, how the 
records are sorted, and so on. The report format refers collectively to 
anything that has to do with the way the report appears. You can issue 
the COLUMN and DETAILED commands to create report formats, or you 
can design your own, which you can then save for future use. 


Sample Database This database, supplied with Cornerstone on its own diskette, is used 
for examples throughout the Beginner's Guide and Owner's Handbook. 
It is an order-entry system, and helps you keep track of customers, 
orders, and parts. 


Sample record When you use the Convert utility to convert files from certain foreign 
formats to a new Cornerstone file, Cornerstone uses a Sample record 


from the foreign file to construct a model for your new database file. 
You can tell Cornerstone which record to use as the sample record 


Save The SAVE command in View, Update, and Select modes allows you to 


save formats and selection criteria that you plan to use again later. 
See Use. 


(SCROLL-BACKWARD) This key scrolls the contents of the data area (re 


port, help message, 
and so on) backward one line. 


(SCROLL-FORWARD) This key scrolls the contents of the data area (report, help message, 
and so on) forward one line. 


Scrolling keys The scrolling keys (PAGE-FoRW ARD), (PAGE 
FORWARD), (SCROLL-BACKWARD), (WINDOW 
RIGHT) scroll the contents of the data area. 


-BACKWARD), (SCROLL- 
-LEFT) and (WINDOW- 
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In Select mode, you enter criteria used to select records for viewing 
You enter Select mode from View mode. When you return to View 
mode, Cornerstone displays only those records satisfying the criteria 
you have specified. 


Selection is the general process of choosing particular records to 
include in a report. (This set of records is called the working set.) 
You can select records manually, by flagging them, or you can have 
Cornerstone select them automatically, using selection criteria that 
you supply. See Automatic selection, Manual selection. 


Selection criteria are criteria used by Cornerstone to select records 
from one of your database files. You enter the criteria in one (or more) 
selection forms in Select mode. Records must satisfy the specified 
criteria in order to be selected. If you plan to use certain criteria 
frequently, you can save them. See Selection. 


The expressions you enter ina selection form are used by 
Cornerstone to select records from your database, and are called 
selection expressions. Selection expressions include range 
expressions (such as “1 ... 100”) and wild card expressions (such as 
“A.'’), Chapter 6, “Entering Information Into Forms,” in Owner's 
Handbook II describes the various kinds of selection expressions 1n 
detail. 


To select records that satisfy particular criteria, you enter the criteria 
ina form called a selection form. Each field in a selection form 
corresponds to an attribute in your file, In any field of a selection form 
you can enter the criteria you want the corresponding attribute to 
meet. For example, to select Customers from Massachusetts, you 
would enter MA in the State field in the selection form. Selection 
criteria may contain more than one selection form. See Selection, 
Selection criteria, Selection expression. 


If you have hidden an element of your report using the REPORT HIDE 
command, you can show it again using REPORT SHOW In View mode. 


An attribute that can have only one value is called single-valued. You 
specify the number of values an attribute can have when you fill out the 
attribute definition form in Define mode. See Multi-valued 
attribute. 


You can arrange the records in a report in a particular order—for 
example, in alphabetical order by name. This is called sorting your 
report. Cornerstone can sort records in Ascending (A to Z, 0 to 9) or 
Descending (Z to A, 9 to 0) order, and can sort using more than one 


attribute. 


A sort specification consists of one or more attributes to sort a report 
on, and a direction to sort by (either ascending or descending) for 
each attribute. This specification tells Cornerstone how to sort the 
records in your report, and is retained as part of the report format if 
you save the format. See Sorting. 
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Source file 


Status line 


Status history 


String 


Subattribute 


Subfield 


Subfile 


Subfile level 


Subform 


Subrecord 


When you use the convert utility, the file that contains the data to be 
converted is called the source file. The source file can be either a 
Cornerstone file or a foreign file. 


See Bottom status line, Top status line, Mode status line, 
Status history. 

Whenever Cornerstone enters a new mode, It displays intormation 
relevant to the mode on the top status line, unless you have 
customized your system to include status history. In this case, when 
Cornerstone enters a new mode, it keeps the old mode status line, 
and creates a new one for the new mode. Cornerstone stacks the status 
lines from the current and previous modes, so that you can see what 
modes the system has been through to get where it is. See Bottom 
status line, Customization. 


One of the data types an attribute can have is String, String attributes 
have one or more text values, each composed of strings of as many as 
255 characters. String attributes are used to store textual information 
such as names, addresses, and notes. 


An attribute of a subfile. We use the term swbattribute when tt 1s 
important to remind you that you are working with an attribute ina 
subfile. Subattributes are treated the same way as attributes by 
Cornerstone. 


A field in a subform. In Format mode, you can manipulate the 
subfields in a subform just as you manipulate fields in the form. 


A file containing subrecords of a main, or parent, file. Whenever 
you define an attribute to be of type Subrecord, Cornerstone creates 

a special file, called the sabfile, where the subrecords are stored. 
Cornerstone gives this file the same name as the subrecord attribute. 
For example, the Sample Database contains a subfile called Line Items 
which contains the subrecords for the Line Jtems attribute in the Order 
file. 


Define mode, the mode that provides commands to manipulate the 
structure of your database, is divided into three levels: Top, File, and 
Subfile. At Subfile level, commands are provided to create and modify 
the subattributes in a particular subfile. See Top level, File level. 


A form (within a form) that corresponds to a subrecord attribute. The 
fields in this form are called subfields. The subform is part of its 
parent form, just as a subrecord is part of its parent record. In Format 
mode, Cornerstone displays the word SUBFORM in the status line 
whenever you move the cursor into a subform. 


This term has two related meanings: (1) it is the name of a 
Cornerstone attribute type, and (2) it is used to denote a record 

in a subfile. One of the types an attribute can have is Subrecord. A 
attribute of type Subrecord has values that are records. These 
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records, called subrecords, all possess the same structure (set of 
subattributes) just as the records ina file all possess tne same 
attributes. Most subrecord attributes are mul/ti-valued, so they can 
have many subrecords. Subrecords are used in applications where you 
want to have a repeating group of information within the records ina 
file. For example, each order record in the Order file in the Sample 
Database contains one or more Line Items. These line items form a 
repeating group: each line item consists of a group of attributes—Part 
number, Description, and so on—and this group is repeated for each 
line item in the order. 


Subtotals are aggregate information, such as sums and averages, that is 
computed for groups of records in a database file. An attribute, called 
the grouping attribute, is used to divide the records into groups; 
records having the same value for the grouping attribute fall within the 
same group. In the report, the subtotals appear following the group of 
records they summarize. See Aggregate expression, Total. 


One of the data types an attribute can have is Time. A time attribute 
has values that are times, such as 12;30 PM or 17:35:59. 


One of the report elements a report format can have is a title. The 
title is used only in printed reports. You can create a title form for a 
printed report using the FORMAT command in Print mode. Titles can 
contain aggregate information, just like totals. See Report element. 


Define mode, the mode that provides commands to manipulate the 
structure of your database, is divided into three levels: Top, File, and 
Subfile. At Top level, commands are provided to create and modify the 
files in your database. See File level, Subfile level. 


The top status line lies above the data area, It shows what mode 
Cornerstone is in, and contains various information depending on the 
mode. See Bottom status line, Mode status line, Status history. 


You can compute aggregate information, such as sums and averages, 
over all the records in your report. Such information is called fotal 
information, or simply totals. Totals are one of the report elements 
that constitute the report. Cornerstone displays the totals at the 
bottom of the report. See Subtotals, Working set. 


See Data Type. 


The underbar character (_) is often used to connect words where 
blank spaces are not allowed. This includes file names, attribute 
names, format names, and selection criteria names. In some situations 
Cornerstone automatically inserts underbars wherever necessary. 


A record is unflagged if there’s no F next to it in View mode. See 
(FLAG/AUNELAG), Flagged record, Manual selection. 


One of the constraints you can impose on an attribute ts that its values 
be wnque. For example, in the Customer file in the Sample Database, 
no two customers can have the same Name. To impose this constraint, 
enter “Yes” for Unique Values? in the attribute definition form in 
Define mode. 
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Update form 


Update mode 


Update set 


Use 


Value 


View mode 


Wild card 


(WINDOW-LEFT) 
(WINDOW-RIGHT) 


Working set 


you do SO D\ 


Whenever you create or change records in Update mode, 
filling out, or editing, a form. This form is called the update form 


In Update mode, you can create, modify, or delete records. You entet 
Update mode from View mode via the UPDATE command. 


When you issue the UPDATE command in View mode, you must select 
the group of records you want to update. This group then becomes the 
update set when you enter Update mode. Any records you create while 
in Update mode become part of the update set. 


You can use a saved format or selection criteria by issuing the USE 
command in View, Update, or Select modes. See Save. 


Values are the basic pieces of information that are stored in the records 
of a file. Each file in your database is made up of records. Each record 
has the same structure, or attributes. But each record can have 
different values for these attributes. The values are whatever you 
enter when you create (or change) the record in Update mode; howevel 
what you may enter as a value for an attribute 1s constrained by the 
type of the attribute as well as any constraints you may have 
imposed when you defined the attribute. For example, an Enumerated 
attribute called Color might only be allowed to have values Red, White, 
or Blue. 


View mode is the basic mode from which to work with a particular 

file in your database. In View mode, Cornerstone displays a report 
containing selected information from your database. View mode 
provides commands to manipulate this report in various ways. In View 
mode, you can change the format, select information to include, and 
compute subtotals and totals. From View mode, you can enter the 
other major modes of Cornerstone, Update and Select modes. 


The wild card symbol is an asterisk (.). This symbol is used in 
selection expressions to match any text. For example, OP matches 
OPTION, OPERATOR, and OPULENCE; «ON matches OPTION, 
ARGON, and TON; and «TI« matches OPTION, NOTICE, and TIP. 
See Non-empty match. 


This key scrolls the contents of the data area horizontally, displaying 
any information off the left or right of your screen. (How much it scrolls 
depends on the value for the Horizontal scroll amount in the 
customization form. ) 


The set of records displayed in View mode (i.e., the records that 
constitute the report) is called the working set. You alter the working 
set by selecting the records you want to view, either manually or 
automatically (using selection criteria). Changing the working set does 
not add or delete records from your file; it simply adds or removes 
records from the display. See Selection. 
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Cornerstone 
Technical Data 


This section describes how Cornerstone stores String, How 

Number, Integer, Date, Time, Enumerated, and Boolean Cornerstone 
values. It also contains formulas for computing the size ofan | Stores Values 
attribute value. You can use these formulas to compute the 
size of a record, which is just the sum of the sizes of all the 
values in the record plus two words to account for overhead 
associated with each record. 





In the following sections, one word is sixteen bits, and one 

byte is eight bits. 
String values are stored in ASCII. The first word of 
the value contains the length of the string. This is 
followed by the string itself. The length of the stored 
string is 1 + (7/2) words, where 7 1s the number of 
characters in the string. (If (7/2) is not a whole 
number, it’s rounded up.) A string can contain any 
printable ASCII character, but cannot contain any 
ASCII control characters. A string can contain both 
uppercase and lowercase characters and is displayed in 
the same way it was entered. Case, however, is always 
ignored when selecting records, sorting records, 
checking uniqueness constraints, and finding related 
records. 


Number values are stored using a format defined by 
IEEE Standard #754. Numbers are 4 words long and 
consist of 10 bits of exponent, 53 bits of mantissa, and 
1 sign bit. Numbers range from + 1e308 to — 1e308 
and the smallest fraction is + le — 308 (308 is a close 
approximation here). Numbers provide 15 decimal 
“om digits of precision. Besides numbers in the range 

Ww described above, the IEEE standard defines three 
numbers to have special significance: 
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* NaN (Not a Number). This symbol is used to 
denote a derived number that is undefined. This 
usually results from taking the square root of a 
negative number, or dividing zero by zero. 


« +Inf(-+ Infinity). This symbol indicates an 
arithmetic overflow. For example, 10°400 results 
in + Inf since 1e400 is greater than the largest 
number that can be represented in Cornerstone’s 
number format. 

« —Inf: (— Infinity). This indicates arithmetic 
overflow when the number is negative. For 
example, — 10°400 results in — Inf. 


Many fractional values have only approximate 
representations in the IEEE number representation. 
For example, 0.9 is actually represented as 
0.8999999999999998. Since the representation is 
approximate, arithmetic operations involving fractions 
can result in rounding errors, which grow with the 
number of arithmetic operations. Because numbers 
have 15 digits of precision, these rounding errors are 
not significant unless many additions or multiplications 
are performed. For example, you can sum a column of 
100,000 numbers with 2 digits after the decimal point 
with no error, as long as the result is less than 

100, 000, 000.00. 








Integer values are stored as number values. They 
occupy Just as much storage space as numbers, and 


arithmetic operations using integers are no faster than 
those for numbers. 
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Integer values (and whole numbers) can be added and 
multiplied without any loss of precision. You can add 
any list of integers, and as long as the result is between 
lel5 and le-15, it will be exact. 





Date values are represented as triplets (Month, Day, 
Year) and require two words of storage. Any date A.D. 
(anno Domini) can be represented; however, date 
arithmetic works correctly only for dates after the 
adoption of the Gregorian Calendar. 


Time values are represented as triplets (Hours, 
Minutes, Seconds) and require two words of storage. 


Enumerated values require one word of storage. 
Each enumerated value you define for an enumerated 
attribute is assigned a unique code between 1 and 255. 
Whenever you enter an enumerated value, 
Cornerstone stores the code rather than the value 
itself. 


Boolean values require one word of storage. 


Multi-valued attributes are stored as a series of 
values. The number of words required for a multi- 
valued attribute is simply the total number of words 
required for all the values, plus one word (the extra 
word contains the number of values). 


Subrecords are stored in their own file, separate 
from the parent record. There is a separate subfile for 
each attribute in the parent file of type Subrecord. A 
subfile is like any other Cornerstone file, except that 
you cannot update it directly. You can update it only 
while updating the parent file. The value for a 
subrecord attribute requires two words of storage in 
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Calculating 
Disk Space 





the parent record. (These two words link the parent 
record to its subrecords.) The subrecords themselves 
are simply records in the subfile. You can compute 
their size using the formulas described above. 


| To calculate the amount of disk space required for your 





database, you must first calculate the amount of storage 
required for your data (using the formulas described in the 
previous section), and then add to this the amount of space 
required by the system (discussed below). 


In a two-diskette system, the Cornerstone data diskette 
initially contains 242K bytes of system information, leaving 
118K bytes for your database. The section Saving Space in 
chapter 10, “Reinstallation and Saving Space,” describes 
ways to eliminate much of the system overhead from your 
data diskette. 


In a hard-disk system, the Cornerstone system files are 
stored in the \.;CORNER directory. 


O Minimum space required by the system on user's data 
diskette: 10K bytes. 


O Size of Help file: approximately 120K bytes (containing 
approximately 200,000 characters of Help text). 


O Overhead for each file and subfile: depends on the 
number of attributes in the file, but is approximately 
4K bytes, plus an additional 1K bytes for every 40 
attributes. 


© Disk space used for each saved format: depends on the 
complexity of the format saved. The minimum for a 
report saved in View mode is 1024 bytes (1K). The 
minimum for a format saved in Update or Select modes 
is 512 bytes. A rough rule of thumb is 50 bytes for each 
field appearing in the form. 
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O Space for each saved set of selection criteria: 512 
bytes (more space may be required for selection 
criteria containing multiple forms). 





QO Space required for each index file: depends on both the 
number of records in the file and the values that are 
indexed. A rough rule of thumb is 
((3%NRECS) + NVALS)«(VALSIZE + 5) bytes, where 
NRECS is the number of records in the file, NVALS is 
the number of different values for the attribute being 





EL) indexed, and VALSIZE is the average size of each 
ee value indexed. 
1 - - ~ ~ = = 
— Cornerstone requires at least 256K bytes of memory and Limits of 
aa two 360K floppy-diskette drives. (Cornerstone will run Cornerstone 
oa faster with more memory and a hard disk. ) 
“i Cornerstone makes use of all available memory. It uses 


- most of this space for the program itself, but gives up pages 
a if to data as needed. 


| Maximum number of files: 120 (this number does not 
“i —_ include subfiles) 


Maximum number of Subrecord attributes per file: 8 


aw Maximum number of attributes per file: 158 
Maximum number of relationships per file: 30 (there can be 
= = i only one relationship between any pair of files) 


Maximum size of a record: 3800 bytes (not counting 
= —— subrecords) 


Maximum size of a file: 8 million bytes 


as ! 3 Maximum size of a subfile: 8 million bytes 
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Maximum number of records in the working set (in View 
mode) at any time: 32,700 


Maximum size of a file or attribute name: 32 characters 


Maximum number of levels of interaction (View modes 
under Initial, View, or Update modes): 8 


Maximum number of values (for a multi-valued 
| attribute): 255 


Maximum number of subrecords in a record: 255 (for each 
Subrecord attribute) 


Maximum number of characters in a value (including 
expressions): 255 





Maximum number of enumerated values: 255 (total size for 
all values cannot exceed 4000 characters) 


Maximum number of saved formats per file: 255 
Maximum number of saved selection criteria per file: 255 
Maximum number of saved print devices: 255 
Maximum width of a format: 255 columns 

File Names Cornerstone stores in several DOS files all the information 
it requires to run. These DOS files have names that are not 
directly related to the names of your Cornerstone files. This 


section describes these files and the conventions used to 
name them in greater detail. 


CS ae You should not attempt to manipulate Cornerstone files 
using DOS commands. 1 You cannot delete individual 
Cornerstone files from DOS. You must delete files from 
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Define mode. Saved formats, selection criteria, and printing 
devices can be deleted in Initial mode, and records can be 
deleted in Update mode. 


You cannot move files from one database to another using 
the DOS COPY and RENAME commands. A Cornerstone 
file is a logical file that is represented physically by a set of 
DOS files. The only safe way to manipulate your files is by 
using Cornerstone. 








we Cornerstone file names consist of an eight-character 
i identification name followed by an extension. In addition, 
these files are divided into two groups: system files and 
c= | database files. They are distinguished by their DOS 
i extension: .CNR for system files, and .DBF for database 
files. 


Cornerstone uses the following system files. 


O FS100000.CNR and FS100099. CNR define all the 
ee system forms in Cornerstone (for example, the form 
‘afl used when defining an attribute). 


—_ we 0 MS000255.CNR contains the Help messages displayed 
LL by Cornerstone whenever you press the (HELP) key. 

This file can safely be deleted if disk space is needed. 
T_ —— The system will continue to operate, but without 
a on-line help. 


om wt All Cornerstone database file names consist of a two-letter 


"_— y prefix indicating the type of information stored in the file, 
: followed by six digits of identification. (A unique 
— - identification number, represented here as “xxxxxx’, Is 


7 i automatically assigned to every database file. ) 





Each database contains the following basic files (“DBF” is 
the default three-letter extension for the database): 


© FILES.DBF is a DOS file that lists the names and 


descriptions of all your Cornerstone files, as well as 
the identification numbers assigned to them by 
Cornerstone. You can TYPE this file to see what 
Cornerstone database files are on the current diskette, 
or in the current directory. 


MS000000. DBF is the master file. This contains the 
information that maps file names into identification 
numbers. 


SY000000. DBF contains the customization information 
you specify when you CUSTOMIZE your system in Initial 
and Convert modes. (If you want to retain your 
customization information throughout several 
Cornerstone databases, you can safely copy this file 
from one database to another. If you copy this file, you 
should also copy the FFO00000. DBF file from the 
same database. ) 


FFO00000. DBF contains the print devices you have 
defined for your system. (If you want to retain your 
print device definitions throughout several 
Cornerstone databases, you can safely copy this file 
from one database to another. If you copy this file, you 
should also copy the SYO00000. DBF file from the 
same database. ) 


FSxxxxxx. DBF: These files define the structure of 
the database. They contain the definitions of the 
attributes and relationships for each database file. 
There is one definition file for every database file and 
one for every subfile. (Definition files are sometimes 
called schema files. ) 
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O FFxxxxxx. DBF: These files contain saved report 
formats, update and selection forms, and selection 
criteria. There is one such file for every database file 
and one for every subfile. 


O FDxxxxxx. DBF: These files contain the data for the 
records. There is one such data file for every database 
file and one for every subfile. 


O I[Xxxxxxx. DBF: These files contain indexes for 
attributes you define to be indexed. There is one index 
file for every indexed attribute. 


O TMxxxxxx. DBF: These files are temporary files used 
by Cornerstone. They are automatically deleted by the 
system in the course of normal operation. If, for some 
reason, you find them on your disk, you can safely 
delete them using the DOS DEL command. 


The BACKUP utility uses the following special files. 

O HEADER.BAK: This file contains a list of the files 
that are backed up, and appears on the first backup 
disk. 

O VOLIDOvn.Bvyn: These files contain the information 
used to identify the backup volume uniquely. The 
volume number (“vn”) is used to make sure you insert 
the backup diskettes in the correct sequence. 

O BSxxxxxx. Bvn: These are the backup files for the 
definition files. 

O BDxxxxxx. Byn: These are the backup files for the 
data files. 

O BFxxxxxx. Bvn: These are the backup files for the 
saved formats and selection criteria. 
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A 


“Abort requested, files have been closed,” 
II: 208 


“Abort requested. WARNING: The database 


may not be consistent,” Il: 208 
ABS function, Il: 136 


Addendum attribute, PFS file conversions and, 


Ik 36 
ADD_INTERVAL— DATE function, II: 138 
ADD_INTERVAL_ TIME function, II: 14] 
ADJUST-WIDTH command, |: 123; Il: 170 
Aggregate functions, |: 91-92; Il: 131-35 
AVERAGE, I: 91 
AVG, Il: 132 
COUNT, I: 91; II: 132 
FIRST, I: 91; I> 135 
in Format mode, I: 130 
LAST, I: 91; I: 135 
MAX, II: 133 
MAXIMUM, I: 91 
MIN, Il: 133 
MINIMUM, I: 91 
with multi-valued attributes, I: 154 
NET-PRESENT-VALUE, I: 92 
with REPORT TOTAL and REPORT SUBTOTAI 
commands, I: 87-88, 91-92 
STANDARD DEVIATION, I: 92 
STDEYV, Il: 134 
SUM, I: 91; Il: 134 
VARIANCE, I: 92; II: 135 
ALL-DONE command, I: 23, 43 
Alphabetizing. See Sorting 
AND-FORM command, |; 77-78 
Anniversaries, reminders of upcoming, II: 8-9 
Anniversary attribute, II: 16 
Annuity 
future value of an, II: 143 
present value of an, II: 144-45 
Appending backup files, II: 84, 85, 89 
Applications of Cornerstone, |: 6-8 
multi-user, II; 89 
Arguments, II: 130. See also Functions (function 
expressions) 
Arrow keys, |: 21; II: 150, 152, 154 
entering commands with, II: 164-65 
ASCII characters, nonprintable, in Convert 
mode, II: 69 
ASCII files. See SDF (Standard Data Format) 
files; TEXT files 
Asterisk (*). See Wild card 
Attributes 
in Client Tracking system, II: 15-19 
changes in, II: 11-12 
in columnar reports, I: 32-33 


data types of | 15, 142-45 
in Convert mode, Il; 29, 32, 30, 36 


5-78 

defining attributes and, I: 169-70, 179 
RECOMPUTE command used to change 

Il: 95-96 

defining or redefining, I: 168-79 
changing an attribute, [: 178-79; II 
in Client Tracking system, II: 11-12 
constraints, [: 171-73 
in Convert mode, II: 29-30 
derivation expressions, I; 176 
description of attributes, I; 169 


95-96 


display information, I: 174-76 

enumerated values, I: 177 

indexed attributes, I: 177 

initial values, I: 177 

LONG-FORM option, [: 168, 170-71 

maintained attributes, [: 177-78 

names of attributes, I: 169; II: 115-17 

SHORT-FORM option, I: 168-70 

types of values, I: 169-70, 179 
definition of, I: 14, 138 
derived. See Derived attributes (or values) 
detailed display of, in View mode, I: 34-36 
enumerated, I; 142, 143. See also 

Enumerated values 

when to use, I: 145 
fields versus, I: 115 
grouping, I: 89-91] 
identifying, planning a database and, I: 141 
indexed, I: 177; Il: 101-2, 109-11 

constraints and, Il: 111 

space requirements for, I]: 237 
maintained, [: 177-78; I: 107-8 

RECOMPUTE command for updating, I]: 94, 96 
mandatory, I: 152, 172. See also Mandatory fields 
multi-valued. See also Multiple values 

defining, I: 172, 179 

importing data into an existing file and, Il: 78 

planning a database and, I: 154-55 

storage of, II; 235 
names of, I: 169; I]: 115-17 
primitive, I: 147, 179 
recomputing values for. See RECOMPUTE command 

(Recompute utility) 

relationships between. See Relatic mnships 
repeating group of, [: 158 
structure of a record as defined by its, I: 138 
subrecord, I: 143, 155-58 
values of, I; 140 


ATTRIBUTES-ONLY option, with REDEFINE-FILE 


command, I: 167 


AVERAGE function, |: 91 
AVG function, II: 132 
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{BACKSPACE) key, I: 21; Il: 150, 153; 164 


Backup utility (Backup mode), I: 17, 25, 193: 


Il: 81-89 
appending files in, II: 84, 85, 89 
commands in, II: 186 
DOS files used by, I: 241 
errors while using, If: 210 
multi-user application of, II: 89 
removing data in, II: 87-88 
reorganizing your database in, Il: 81, 86-87 
restoring files in, Il: 81, 85-86 
sorting backup files in, Il: 82-83, 88 
tasks that can be done in, II: 174, 186 
“Bad command or file name,” II: 190 
Batch file. See also CORNER.BAT file; 
SETUPHD.BAT file 
customization of, Il: 192-96, 199, 201 
BDxxxxxx.Bvyn, II; 241 
Begin at record number entry, in Convert 


mode's customization form, II: 51, 58, 


69-70 

Beginner's Guide, |: 4; Il: 197 
Bell ringing with error messages, I: 192 
BFxxxxxx.Byn, II: 241 
Birthday attribute, II: 16 
Birthdays, reminders of upcoming, II: 8-9 
Blank lines, in pre-printed forms, I: 107, 129 
Boolean data type, [: 142, 145 

conversion of, II: 78 

entering values of, II: 119 

storage of values of, II: 235 
Bottom status line, I: 19; II: 162 
BSxxxxxx. Byn, Il: 241 
Bullets, for subrecords, I: 132 


Cc 


CALCULATE command, I: 86. See also REPORT 
CALCULATE command 

in Format mode, I: 126 

in Select mode, I: 75 
(CANCEL) FORM command, [: 53, 167; Il: 151 
(CANCEL) key, I: 21 

at command level, II: 164 

in Edit mode, Il: 150, 153 

to erase the command line, Il: 161, 164 
(CANCEL) VALUE command, I: 23; II: 150, 153 
Changeable values, |; 173 
CHKDSK command, II: 209-10 
CLEAR command, II: 157 
Client Tracking file, Il: 5-7 

attributes in, II: 17-19 


Company Name relationship between People file 
and, II: 13-14, 16, 17 

formats and selection criteria for, Il: 20 

as Patient History file, Uf; 10-12 

seeing all information in, Il: 9 

used by itself, II: 7, 11, 13 


Client Tracking system, I: 5; II: 3-20. See also 


Client Tracking file; Peaple file 
adding data in, Il: 6-7 
Company Name relationship in, Il: 13-14, 16, 17 
Contact History section of, Il: 7 
Contact People restriction in, I: 13 
contacts as subrecords in, I: 156-57 
detailed description of files and attributes in, 
II: 15-19 
installing, Il: 3-4 
personalizing 
attribute changes, II: 11-12 
file changes, LI: 10-11 
re-establishing relationships, Il: 12 
personalizing, Il: 9-12 
pre-defined formats and selection criteria in, 
II: 8-9, 19-20 
reminders in 
birthdays and anniversaries, II: 8-9, 19 
whom and when to call, Il: 9, 20 
removing a relationship between files in, 
II: 11, 13 
renaming files in, I: 11 
Sales database in, Il: 42 
Line Items subfile, Il: 43-46, 55, 60 
Sales Tracking file, I: 55-60 
sample data in, Il: 6 
tips on using, If: 12-15 
using, II: 4-7 


Color monitor, I: 192; Il: 163 
Colors, switches for setting, II; 192-94 
Columnar reports, I: 32-34 
COLUMN command 
in Format mode, I; 124-25 


Update format and, I: 62 


in View mode, I: 32-33 
COMMAND.COM file, Il 195 
(COMMAND) key, II: 154, 156, 167 

in Format mode, I: 117 
Command keys, II: 168-69 
Command line, I: 19, 20; Ik 161 
Commands. See also specific commands 

in Backup mode, II: 186 

in Convert mode, II: 185 

in Define mode, II: 182-84 

in Edit mode, II: 156-57, 180 
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entering, I: 20: Il: 163-70 
with arrow keys, II: 164-65 
with (COMMAND) key, I: 167 
with command keys, Il: 168-69 
with control keys, II: 170 
(HELP) key for assistance with, II: 165-66 
keyboard entry, II: 163-64 
(OPTIONS) key and, II: 166 

in Format mode, I: 117, 118; II: 181 

in Initial mode, II: 175 

no activity after issuing, Il: 208 

in Print mode, II; 184-85 

in Select mode, II: 179 

in Update mode, II: 178 

in View mode, I]: 176-77 


log nonprintable ASCII characters, If: 69 
number of errors displayed, Il: 67 
number or errors before abort, II: 66 
restore database if aborted, Il: 68-69 
use defined constraints, II: 68 
data types for attributes in, II: 29, 32, 35, 36, 
53, 75-78 
analyzing exported data, Il: 75-76 
analyzing imported data, Il: 75 
conversion of, Il: 76-77 
incorrect data type error, Il: 72 
dBASE II files, I: 41 
dBASE III files, Il: 41 
DIF (Data Interchange Format) files, II: 42, 
60-61 





Commas, display of, I: 174 
Company Name attributes, relationship 
between, II: 13-14, 16, 17 


DOS file names in, II: 25 
errors in, II: 71-73 
customization of Convert mode, Il: 66-69, 71 
Constants, entered as a derivation or initial value incorrect data type, II: 72 
expression, II: 130 MailMerge files (mailing lists), converting to, 
Constant text, I: 116, 117; Il: 167 II: 27 
in Format mode, I; 132 1-2-3 files, converting from, II: 53, 59 
in pre-printed forms, I: 106, 107 1-2-3 files, converting to, II: 46 
Constraints, [: 52-53; Il: 68 PFS files, converting from, II: 37, 40 
appending data to a file and, II: 89 SDF (Standard Data Format) files, converting 
built-in, I: 53 to, Il: 63 
changeable values, I: 173 truncation and spillover, II: 73 
formats that can be converted by, II; 23-24 
(HELP) key in, II: 25 
kinds of conversions in, II: 24 
MailMerge files (mailing lists), II: 25-34 
EXISTING-FILE option, II; 31-34 
exporting to, II: 25-28 
importing, Il: 28-31 
1-2-3 and other spreadsheet files, II: 41-60 
converting database information from, II: 48 
converting from Cornerstone to, II: 43-47 
Contact History subrecord, II: 7, 18 customization form for, II: 50-52 
Contact People subrecord, II: 13, 15, 18 existing file, converting from 1-2-3 to an, 
Control keys, I: 22; If: 155, 170. See also entries Il: 54-60 
starting with Ctrl- new file, converting from 1-2-3 toa, II: 48-54 
Convert utility (Convert mode), I: 17, 193; Il: 7 numbers, conversion of. II: 77 
23-78 Sales database, II; 42 
command summary, II: 185 outline description of what happens during 
customization of, II: 65-71 conversion, II: 73-75 
attribute names in record number, II: 70 PFS: File files, I: 35-40 
begin at record number, II: 51, 58, 69-70 existing file option, II: 38 
converting from 1-2-3 files to new Cornerstone sample record, II: 28-29 
file, Il: 50-52 SDF (Standard Data Format) files, Il: 61-64 
create error log file, II: 67 truncation and spillover errors and, II: 73 
error attribute name, II: 69 stopping a conversion in, II: 30 
fix errors during conversion, II: 68 Symphony, II: 42, 45, 47 


hex field delimiter string, II: 71 tasks that can be done in, II: 174, 185 
hex record delimiter string, II- 70 TEXT files, Il: 65, 70-71 


cross-file range. See Cross-file range constraints 
defining attributes and, I: 171-73 

efficiency techniques and, II: 111-12 

indexing attributes and, II: 102, 111 

for initial values, I: 56 

mandatory values, I: 172 

maximum length, I: 172 

maximum number of values, I: 172, 179 
minimum value and maximum value, I: 53, 173 
umque values, I: 172; II: 111-12 
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in two-diskette systems, II: 28, 34 
COPY command (Ctrl-D), I: 54; Il; 155, 157, 170 
Copying 
a fresh copy of Sample Database to a hard disk, 
Il: 197 
system files, II; 191 
CORNER.BAT file, customizing, Il: 192-96, 
199, 201 
CORNER directory, I[: 236-37 
Cornerstone 
applications of, I: 6-7 
multi-user, II: 89 
characteristics of, I: 6-8 
installing. See Installation procedures 
limits of, Il: 237-38 
restricting memory available for, Il: 195 
running, I: 13-14 
problems with, Il; 206 
system files 
copying, II: 19] 
names of, Il: 239 
“Couldn’t read file: CORNER.MME,” II: 206 
COUNT function, [: 91; [l: 132 
Crash recovery procedures, Il: 205-10 
Backup utility and, II: 210 
causes of, II: 205-8 
abnormal exits, II: 207-8 
disk errors, Il: 205 
no activity after issuing a command, II: 208 
power failure, II: 205 
start-up problems, Il: 206 
CHKDSK command and, II: 209-10 
what to do, II; 209-10 
Creating a database, |: 163. See also 
Define mode 
Creating records, [: 47-48, 51-54. See also 
Update mode 
Creating subrecords, |; 57 
Cross-file range constraints, I: 152-53, 173 
efficiency techniques and, II: 111-12 
entering expressions for, Il: 128 
entering values for attributes with, II: 117-18 
(OPTIONS) key and, Il: 155 
‘ce (color) switch, Il: 192-94 
Ctrl-A (START-OF LINE), I: 22; If: 155, 170 
Ctrl-Alt-Del, when there is no activity after 
issuing a command, II: 208 
Ctrl-Break (Abort), I: 24, 41, 70, 108; Il: 170 
messages that appear after pressing, II: 208 
when there is no activity after issuing a 
command, II: 208 


Ctrl-D (COPY PREVIOUS VALUE), I: 54; Il: 155, 170 


Ctrl-E (END-OF LINE), [: 22; Ik 155, 170 
Ctrl-F (OTHER-FORM), Il: 170 


Ctrl-K (CLEAR REST-OF-VALUB), [: 22; II: 151, 155, 
155, 170 
Ctrl-L (REDISPLAY), Il: 170 
Ctrl-N (INSERT), II; 155, 170 
Ctrl-R (SET-CHARAC), Il: 170 
Ctrl-U (RECOMPUTE), Il: 97, 155, 170 
Ctrl-V (move), II: 170 
Ctrl-W (Absust-wipTu), Ll: 170 
Ctrl-X (DELETE), Il: 155, 170 
Current device, I: 103 
CURRENT-RECORD option, in Update mode, 
I: 49, 50 
Current Status attribute, in Client Tracking file, 
Il: 15, 19 
Cursor 
in Edit mode, II: 150-55 
in Format mode, I: 117 
menu, II: 164 
record, I: 30, 32 
Customization 
of batch file, Il: 192-96, 199, 201 
of Convert utility. See Convert utility 
customization of 
CUSTOMIZE command, |; 190-92 


D 


Data area, |: 19; Il: 162 
Database 
creating a new, I: 163 
defining (building) a, I: 163-86. See also 
Define mode 
definition of, I: 14, 137 
designing a, I: 137, 141-60 
data types of attributes, l: 142-45 
derived attributes, l: 145-49 
example of, L: 159-60 
identifying files and attributes, I: 14] 
initial values, I: 145, 147-49 
multi-valued attributes, I: 154-55 
relationships, I: 149-53 
subrecords and subfiles, I: 155-58 
elements of a, I: 14-15, 137-40 
reorganizing a, II: 86-87 
Sample. See Sample Database 
structure of a, I: 14-15 
Database files. See also Files 
names of, Il: 239-41 
“Data directory xyz does not exist, The,” 
Il: 206 
Data diskettes. Sce also Diskettes 
COMMAND,COM and MME.EXE files on, 
II: 195, 198 
“The data disk is nearly full..." warning, Il: 206 





248 Index 





saving space on, Il: 198-20] 
space requirements for, Il: 236 
“Data disk is nearly full..., The,” Il: 206 
Data entry. See Entering; Update mode 
“Data memory space exhausted,” [[: 207 
Data types, I: 15, 142-45 
converting files and, II: 29, 32, 35, 36, 53, 
75-78 
analyzing exported data, II: 75-76 
analyzing imported data, I]: 75 
conversion of, II: 76-77 
incorrect data type error, II: 72 
defining attributes and, I: 169-70, 179 


RECOMPUTE command used to change, II: 95-96 


Date functions, II: 138-40 
Dates 
data type for, I: 142 
conversion of, Il: 77 
display characteristics of, I: 175-76 
entering values for, II: 120-23 
expressions that can be entered for, I: 144: 
II: 121-23 
ranges for, Il: 126-27 
Storage of, II: 235 
Dates format, in People file, II: 9, 19 
DAY function, II: 138 
DAY_OF_WEEK function, II: 138 
dBASE II files, Il: 24, 41, 77 
dBASE Ill files, Il: 24, 41 
Decimal point, number of digits to display 
following, I: 174 
Defaults 
printing, I: 99 
system, I: 190-92 
DEFINE command, |: 163 
Define mode, I: 17, 94, 163-86 
attributes in, I: 168-79 
changing an attribute, I: 178-79 
constraints, I: 171-73 
deleting attributes, I: 183-84 
derivation expressions, I: 176 
description of attributes, I: 169 
display information, I: 174-76 
enumerated values, |: 177 
indexed attributes, I: 177 
initial values, I: 177 
LONG-FORM option, I: 168, 170-71 
maintained attributes, I: 177-78 
name of attributes, I: 169 
SHORT-FORM option, I: 168-70 
types of values, I: 169-70, 179 
commands in, II: 182-84 
deleting files and attributes in, I: 183-84 
display in, I: 165 


file level in, I: 164 
files in 
changing a file, [: 167 
creating a new file, I: 166-67 
deleting files, I: 183-84 
leaving, I: 185 
levels of, I: 163-64 
overview of, I: 163-65 
printing in, I; 108, 185 
relationships in, I: 180-82 
subfile level in, I: 164 
subrecords in, I: 182-83 
tasks that can be done in, II: 174, 182 
top level in, I: 163 
DEFINE-NEW-ATTRIBUTE command, |: 168 
in Client Tracking system, Il: 11 
DEFINE-NEW-FILE command, I: 166 
DEFINE-RELATIONSHIP command, [: 180-81 


DELETE ALL-UPDATE-RECORDS command, |: 58 


DELETE-ATTRIBUTE command, |: 183-84 

in Client Tracking system, II: 11-12 
(DELETE-CHAR) key, I: 22; II: 150, 153 
DELETE command, II: 157 

in Initial mode, I: 192-93 

in Update mode, I: 58-60 
DELETE CURRENT-RECORD command, |: 58 
DELETE DEVICE command, I: 105, 193 
DELETE FIELD command, |: 120 
DELETE-FILE command, I: 183-84 
DELETE FORMAT command, |: 192 
DELETE FORM command, |: 125 
DELETE LINES command, I: 124 


DELETE SELECTION-CRITERIA Command, I: 192 


DELETE-SUBATTRIBUTE Command, I: 184 
DELETE SUBFORM command, I: 126 
Deleting. See also specific DELETE commands 
attributes, I: 183-84 
in Client Tracking system, II: 11-12 
files, I: 183-84 
the Help file, II: 199, 202 
records, I: 58-60 
empty records, I: 54 
Delimiters 
hex field, II: 71 
hex record, I: 70 
Derivation expressions, I: 15, 146 
defining attributes and, I: 176 
entering, II: 128-45 
constants, II: 130 
function expressions. See Functions 
mappings, II: 129 
enumerated values in, II: 119 
(OPTIONS) key and, II: 156 
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Derived attributes (or values), I: 52, 54, 143 
CALCULATE command used to create, [: 75 
changing data types of attributes and, Il: 96 
changing primitive attributes to (or vice versa), 
I: 179; II: 94, 103-7 

in Convert mode, [I: 33 

definition of, I: 15 

efficiency techniques and, [l: 103-8 

in Format mode, I: 126 

initial values versus, I: 147-49 

as non-editable, I: 22 

planning a database and, I: 145-49 

relationships between files and, I: 150-51, 153 

relationships defined by, Il: 103, 106-7 

REPORT CALCULATE command and, J; 93-94 

in selection forms, I: 68 

VIEW command as faster than selecting, II: 109 

Derived fields, I: 54. See also Derived attributes 

(or values) 

Description 
of attributes, I: 169 
of files, I: 166 


Designing databases. See Database—designing a 


Designing forms, I: 111-34. See also 
Format mode 
DETAILED ALL-ATTRIBUTES command, I: 35 
designing forms and, I: 125 
DETAILED command, |: 111 
in Format mode, [: 124-25 
Update format and, I: 60-61 
in View mode, I: 34-36 
DETAILED SOME-ATTRIBUTES command, I: 34 
DEVICE command, I: 103-5 
DIF (Data Interchange Format) files, Il: 23, 
42, 60-61 
dBASE III file conversion and, [I 41 
DIR command, II: 81 
Diskettes. See also Data diskettes; Disk space; 
Two-diskette system 
backing up to, II: 81, 83-84 
errors due to faulty, I: 205 
high-density, saving space on, Il: 200-1 
restoring files from, Il: 81, 85-56 
removing, |: 25 
“Disk full,” [l: 207 
Disk space. See also Saving space 
calculating, Il: 236-37 
for indexes, II: 102 
Display information (or style), defining 
attributes and, I: 174-76 


Display screen. See Screen 
Dollar sign, display of, lI: 123, 174 
(DONE) key, I: 21; Il: 151, 153 

in View mode, [: 43 


DOS commands, |: 25; I]; 238-39 
CHKRDSK, Il: 209-10 
DIR, Il: 81 
for moving Cornerstone to a second computer, 
Il: 196-97 
for terminating the batch job SETUPHD. BAT, 
II: 189-90 
DOS error messages, for installation problems, 
I]: 190-91 
DOS file names 
in Convert mode, II: 25 
names of, II: 238-41 
“Drive not ready on device B,” II: 190 


EDIT command, I: 21 
in Update mode, I: 51 
Edit mode, I: 17; II: 149-57 
(COMMAND) key in, II: 167 
commands tn, Il: 156-57, 180 
entering and editing information in, k: 21-23; 
Il: 149-56 
checking values, II: 152 
command keys, II: 153-54 
control keys, [l: 155 
moving from field to field, II: 151-52 
options, [[:,155-56 
status line, II: 149 
typing values, II: 150-51 
RECOMPUTE command in, I: 56; I: 97 
tasks that can be done in, Il: 174, 180 
type-in style in, I: 190 
Efficiency considerations, II: 101-12 
constraints, II: 111-12 
derived attributes and, II: 103-8 
maintained attributes, II: 107-8 
making a derived attribute primitive, II: 103-7 
RECOMPUTE command and initial values, 
I: 104-6 
formats, If: 112 
hard disk system, II: 112 
indexing attributes, II: 101-2, 109-11 
memory, II: 112 
for multi-file selections, II: 108-9 
numbers and relationships, II: 110-11 
processing and display of records, II: 110 
sorted reports and the View mode default 
format, Ik: 110 
Ellipsis (...), IL: 164 
in selection forms, I: 71-72; [1: 126-27 
Employment History subrecords, |: 156 
Empty fields, selection of, : 73; Lk 127 
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Empty records 
automatic deletion of, I: 54 
selection of, Il: 127 
END-OF command, I[I;, 157 
Entering 
commands, II: 163-70 
with arrow keys, 164-65 
with (COMMAND) key, II: 167 
with command keys, Il: 168-69 
with control keys, Il: 170 
(HELP) key for assistance with, II: 165-66 
by keyboard entry, Ik 163-64 
(OPTIONS) key, II: 166 
derivation and initial value expressions, 
Il: 128-45 
constants, II: 130 
function expressions. See Functions 
mappings, II: 129 
range constraint expressions, II: 128 
records. See also Update mode 
in Client Tracking system, II: 7 
examples from Sample Database, I: 47-49 
selection expressions, I]: 124-28 
empty records, I: 73; Il: 127 
exact match, I: 70; Il: 124 
literal interpretation of selection terms, II: 128 
non-empty records, I; 73; I: 127 
NOT (negation of a criterion), I: 74-75; Il: 127 
ranges, I: 71-73; II: 126-27 
values, I: 21-23; Il: 115-24. See also 
Update mode 
date values, I]: 120-23 
enumerated values, I]: 119 
integer values, II: 119 
keys and control keys for, I: 21-22 
in new records, I: 51-54 
number values, II: 118 
in selection forms, I: 67-69 
String values, II: 115-18 
in subrecords, I: 57 
tume values, II: 123-24 
(ENTER) key 
entering commands with, If: 165 
entering values and, I: 21-23; II: 151-53 
Enumerated attributes 
sorting, I: 41 
when to use, I: 145 
Enumerated data type, I: 142, 143, 145 
conversion of, II: 78 
Enumerated values, I: 142, 143 
defining attributes with, I: 177 
designation of, [: 145 
entering, II: 119 
letters for, I: 145 


OPTIONS) key and, II: 155 
storage of, Il; 235 
Error attribute, II: 69 
Error line, I; 19, 20; Il; 161 
Error log file, Il: 67 
Error messages, [: 19, 20 
for abnormal exits, II; 207-8 
for disk errors, II: 205 
in Edit mode, II: 150, 151 
entering values and, I: 52-53 
(HELP) key for, II: 166 
for installation problems, Il; 190-91 
ringing of bell with, I: 192 
for start-up problems, II: 206 
Errors 
conversion. See Convert utility (Convert mode) 
errors in 
disk, II: 205 
/e (extension) switch, II: 195-96 
Exact match selection, |: 70; Il: 124 
EXISTING-FILE option, [I: 38, 54-60 
with MailMerge files (mailing lists), II: 31-34 
EXIT command, |: 23, 24, 189 
Exits, abnormal, II: 207-8 
“Exit value: m, module: n,”’ II; 208, 210 
EXP function, IJ: 136 
Exporting files. See Convert utility 


F 


FDxxxxxx. DBF, II: 241 
FF000000.DBF, II; 240 
FFxxxxxx.DBF, II: 241 
Field characteristics form, |: 121-23 
Field delimiter, in Convert mode, Il: 71, 74 
Fields 
attributes versus, I: 115 
converting files and, II: 74 
derived, I: 54 
in Format mode, I: 115 
manipulating, I: 118-20 
setting characteristics of, I: 120-23 
summary forms, I: 130 
mandatory, I: 53, 62; Il: 15] 
moving between, in Edit mode, II: 151-52 
names of, I: 115, 121-22 
omitted in pre-printed forms, I: 129 
non-editable, I: 22, 52, 122 
File definition form, I: 166-67 
File level, in Define mode, I: 164 
printing at, I: 185 
Files 
backing up. See Backup utility 
converting. See Convert utility 
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defining (creating) 
changing a file, I: 167 
creating a new file, |: 166-67 
deleting files, L- 183 
definition of, I: 14, 137 


description of, in file definition form, I: 166 
DOS, II: 238-41 


overview and concepts used in, I: 113-16 
pre-printed forms in, I: 127-29, 134 
printing in, I: 108, 126-29 

selection forms in, I: 81 

SET-CHARAC command tn, I: 52, 120-123 
subforms in, k 116 


DETAILED and COLUMN commands and, [: 125 


mal DOS commands not usable for manipulation of, inserting lines, I: 124, 133 
; If; 238-39 manipulating, I; 125-26 
“e identifying, planning a database and, I: 14] subtotal, total, header, or title forms in. I: 130 
Jumping between, in View mode, I: 29, 42-43 tasks that can be done in, Il: 174, 181 


maximum limits of, Il: 237-38 
names of 
DOS files, If: 238-41 
H entering values for, II; 115-17 
i in file definition form, I: 166 
parent, I: 156 
relationships between. See Relationships 


ups for designing forms in, I: 132-133 
type-in style in, I: 190 
underbars in, I: 114, 133 
using, [: 117-18 
when to use, I: 133-34 
with two forms, I: 130-31 
Formats. See Reports (report formats) 


reorganizing, II: 86-87 Form feed string, I: 104 
ay system, II: 239 Form letters, [: 107-8, 132 
ay | copying, II: 19] Forms 

ft FILES.DBP, Il; 240 basic elements of, I: 114-16 


Financial functions, II: 143-44 

Financial quarter, ranges for, Il: 127 

W” FIRST-FILE-INFO-THEN-ATTRIBUTES option, with 
REDEFINE-FILE command, |: 167 
FIRST function, [: 91; Il: 135 selection. See Selection forms 
(FIRST) key, 22 Fractional values, storage of, II: 234 
\y* in Edit mode, II: 152, 153 FS100000.CNR, If: 239 

FLAGGED (or UNFLAGGED) records FS100099.CNR, Il: 239 


definition of, I: 113-14 

entering information in. See Entering 
maximum width of, I: 191] 
pre-printed. See Pre-printed forms 


a in Select mode, I: 67 FSxxxxxx.DBF, Il: 240 
——) in Update mode, I: 50 Function keys, I: 18 
we FORMAT command, I: 81, 86. See also REPORT Functions (function expressions), II: 130-45 
= FORMAT command aggregate, II: 131-35 
Wal in Print mode, I: 105, 113 date, Ll: 138-40 
a in Select mode, I: 113 financial, II: 143-44 
i in Update mode, I: 113 mathematical, Il: 136-37 


Format mode, I: 17, 34, 94, 111-34 string, II: 145 


CALCULATE command in, I: 126 

changing whole forms in, I: 124-25 
(COMMAND) key in, Il: 167 

commands in, I: 117, 118; II: 181 

constant text in, I: 116, 117, 132 

data as unaffected by, I: 114 

detailed form compared to form designed in, 


time, II: 141-42 


Future value of an annuity, [: 143 
FV function, II: 143 


G 


GRID option, with PRINT command, I: 126 


oe I: 111-12 Grouping attributes, I; 89-91 
a fields in, I: 115 
” manipulating fields, I: 118-20 H 
Ld setting characteristics of, I: 120-23 Hard-disk system 

~ = summary forms, I: 130 customizing batch file for, II: 192, 194 

“he leaving, I: 131 installing Client Tracking system on a, II: 3-4 
lines in, I: 116 installing Cornerstone on a, I; 13-14 

Ai constant text used to draw, [: 132 recopying the Sample Database to a, II: 197 
~ manipulating, I: 123-24 restoring backup files from a, II: 86 


mistakes commonly made in, I: 133 


Sales database on a, II: 42 
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saving space on, II: 201-2 
space requirements for, ll: 236-37 
speed gained by using, II: 112 
s switch and, If; 194 
terminating the batch job SETUPHD. BAT on a 
II: 189-90 
HEADER.BAK, Ik: 241 
Headers, in Format mode, I: 130, 132 
Help file (MS000255.CNR), Il: 239 
deleting, II; 199, 202 
(HELP) key, I: 4, 22, 23; Il: 152, 153, 165-66 
in Convert mode, I]: 25 
Help message, clearing from the screen, I: 2 
HEX/ASCII Chart, If: 242 
Hex field delimiter string, Il: 7] 
Hex record delimiter string, Il: 70 
HIDE command, |: 86, 92-93 
High-density diskettes, saving space on 
II: 200-1 
Horizontal scroll amount, |: 191 
Hot line, II: 208, 210 
HOURS function, I: 141 
/h (highlight) switch, [[: 192-94 


2 
> 


IEEE Standard #754, Il: 233-34 
Importing files. See Convert utility 
Incorrect data type, II: 72 
Indexed attributes, I: 177; II: 101-2, 109-11 
constraints and, II: 111 
Space requirements for, II: 237 
INDEX function, II; 145 
— Inf (—Infinity), Il: 234 
+ Inf (+Infinity), I: 234 
Initialization string, |: 104 
Initial mode, [: 17, 189-94 
commands in, Il: 175 
CUSTOMIZE command in, I: 190-92 
DELETE command in, I: 192-93 
EXIT command tn, I: 189 
NEW-RECORD command in, I: 51 
tasks that can be done in, II: 174, 175 
utilities in, [: 193-94 
UTILITIES RECOMPUTE command in, I: 57, 194 
Initial set, selection by form and, I: 70 
Initial value expressions 
changing data types of attributes and, II: 96 
defining attributes with, I: 177 
derived attributes changed to primitive attributes 
with, Il; 94, 103-7 
entering, II: 128-45 
constants, I: 130 
function expressions. See Functions 
mappings, II: 129 


enumerated attributes with, II: 119 


of new attributes, Il: 93-94 
Initial values, [: 55 
derived attributes versus, [: 147-49 
planning a database and I: 145, 147-49 
RECOMPUTE command and, II: 93-95, 104-6 
recomputing, I: 56-57; II: 94-95 
relationships between files and, 1: 149, 153 
INIT-VALUE command, |: 56 
INSERT command, II: 157 
INSERT FIELD command, I: 119, 120, 130 
INSERT LINES command, I; 123-24, 133 
INSERT SUBFORM command, |: 125 
(ns/ovs) key, I: 22, 190; Il: 150, 154 
INSTALL command, II: 197 
Installation procedures, I: 5, See also 
Running Cornerstone 
for Client Tracking system, II: 3-4 
customization of, II: 192-96, 199, 201 
moving Cornerstone to a second computer, 
II: 196-97 
problems with, II: 189-91 
Instructions, constant text as, I: 132 
INTEGER function, Il: 136 
Integers 
changing numbers to (or vice versa), I: 179 
as data type, I: 142-44 
conversion of, Il: 77 
display characteristics for, I: 144, 174-75 
entering values of type, II: 119 
storage of, Il: 234-35 
INTEREST function, II: 143 
Interest rate, II: 143 
INTERVAL_— DATE function, II: 139 
INTERVAL_TIME function, II: 142 
IXxxxxxx.DBF, II: 241 


J 
K 


Keyboard, entering commands from the, 
Il: 163-64 
Keyboard template, I: 18 
Keys, I: 18 
command, II: 168-69 
control, II: 170 
for entering and editing values, I: 21-22 


L 


Labels, mailing, I: 105-6 

with Client Tracking system, II: 8, 19 
LAST, entering dates with, Il: 121-23 
Last Contact Date attribute, [I: 15, 18 
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LAST function, I; 91; Il; 135 
(LAST) key, 1: 22; Il: 152, 154 
Limits of Cornerstone, Il: 237-38 
Line feed string, |: 104 
Line items, subrecords for, I: 155-56 
Line Items subfile, in Sales database, 
II: 43-46, 55 
Lines 
blank, in pre-printed forms, I: 107, 129 
in Format mode, I: 116 
constant text used to draw, I: 132 
manipulating, Ll: 123-24 
LN function, If: 136 
LOG10 function, I: 136 
LONG-FORM option, with DEFINE-NEW-ATTRIBUTE 
command, |; 168, 170-71 
Lotus 1-2-3 files. See 1-2-3 files 


Mailing labels, I: 105-6 
with Client Tracking system, Il: 8, 19 
MAILLIST.ERR file, Il: 27 
MAILLIST.MMG file, Il: 27, 28 
MailMerge files (mailing lists), Il: 23, 25-34 
EXISTING-FILE option for converting, If; 31-34 
exporting to, Ik 25-28 
importing, II: 28-31 
Maintained attributes, [: 177-78; II: 107-8 
RECOMPUTE command for updating, Il; 94, 96 
Mandatory attributes, I: 152 
Mandatory fields, I: 53, 62; Il: 151 
Mandatory values, I: 172 
Mappings, II: 129 
Mathematical functions, II: 136-37 
MAX function, II: 133 
Maximum form width, I; 191 
MAXIMUM function, I: 91 
Maximum length, I: 172 
Maximum limits of Cornerstone, II: 237-38 
Maximum number of values, I: 172, 179 
for subrecords, I: 182 
Maximum values, I: 53, 173 
Memory 
Cornerstone requirements, II: 237 
error messages when system runs out of, Il: 207 
restricting Cornerstone’s use of, II: 195 
speed gained by adding, Il: 112 
Menu, I: 20 
cursor, Il: 164 
lines to display, I: 190 
window, I: 19; II: 161 
MIN function, Il: 133 
MINIMUM function, |: 91 


Minimum values, |: 53, 173 
—Inf (—Infinity), Ik: 23 
MINUTES function, Il 142 
MME program (MME.EXE file), Il: 192-96 
Modes, I: 16-17. See also specific modes 
MONTH function, Il: 139 
MOVE FIELD command, I: 119-20 
MOVE LINE command, |: 124 
MS000000.DBE, If 240 
MS000255.CNR (Help file), Il: 239 
deleting, Il: 199, 202 
Multiple values. See also Multi-valued attributes 
entering, I: 22, 51-52; II: 151 
in selection forms, I: 68-69 
Multi-user application of Cornerstone, II: 89 
Multi-valued attributes. See also Multiple values 
defining, I: 172, 179 
importing data into an existing file and, Il: 78 
planning a database and, I; 154-55 
storage of, Il; 235 


Names of files or attributes. See Attributes 
names of; Files—names of; 
Renaming files 

NaN (Not a Number), II: 234 

NEGATE command, |: 78 

Negation of a criterion (NOT), I: 74-75; Ik: 127 

Negative numbers, |: 174 

NET-PRESENT-VALUE function, I: 92 

NEWDB, to create a new database, I: 163 

NEW-RECORD command, I; 47, 50, 51 

NEXT, entering dates with, Il; 122-23 

(NEXT) key, I: 21 

in Edit mode, II: 152, 153 

Non-editable fields, I: 22, 52, 122 

Non-empty records, selection of, l: 73; Il: 127 

NOT, in selection forms, I: 74-75; Il: 127 

Notes attribute, in Client Tracking system, 
Il: 17, 18 

“Not ready error reading drive B,” II: 191 

NOW function, I: 144; If: 142 

Number(s) 

changing integers to (or vice versa), I: 179 
as data type, I: 142-44 
conversion of, II: 76-77 
display characteristics for, I: 144, 174-75 
entering values of type, Il: 118 
ranges for, II: 126 
storage of, Il: 233 
Numeric characters, string of, II: 117 








254 Index 





Oo Primitive attributes, lk 14% 


changed to maintained attributes Ik: 108 


[ok] symbol, II: 161, 165 
1-2-3 files, Il: 23, 41-60 
converting from, II: 48-60 


changing derived attributes to (or vice versa) 
I: 179; Il: 94, 103-7 
PRINT command, I: 99, 102. See also Printing 
(Print mode) 
in Define mode, I; 108, 185 
in other modes besides View, I: 108 
in Select mode, I: 82, 108 
- in Update mode, I: 62, 108 


dates, Il: 77 PRINT DISK command, to export to a TEXT file, 
numbers, Il: 77 1] 
times, II: 77 
(OPTIONS) key, I: 4, 22, 24; Il: 150, 153, 
155-56, 166 
OR-FORM command, |: 76-78 
OTHER-FORM command, [: 131 


Owner's Handbook, |: iii, 4, 9 


customization form for, II]: 50 
database information, Il: 48 


yw OW ON 


to an existing Cornerstone file, Il: 54-60 
to a new file, Il: 48-54 
converting to, Il: 43-47 


65 
Printers, |: 99 
devices for, I: 103-5 
Print form, I: 100-2 
for mailing labels, I: 106 
PRINT FORM command, I: 126 
PRINT GRID command, [: 126 
Printing (Print mode), [: 17, 99-108 


P commands in, II: 184-85 
(PAGE-FORWARD) (or (PAGE-BACKWARD)) key, database definitions, I: 185 
II: 154 defaults for, I: 99 
Page overlap, |: 191 devices 1n, I: 103-5 
Parent files, [: 156 FORMAT command in, I: 105, 113 
Parent records, |: 156 form letters, I: 107-8 
Patient History file, Il: 10-12 interrupting, I: 108 
Payment for the period, II: 144 mailing labels, I: 105-6 
People file, tk 4-7 pre-printed forms, [: 106-7 
attributes in, I]: 15-17 saving instructions for, I: 102 
birthday and anniversary information in, II: 8, 16 selection criteria, I: 82 
Company Name relationship between Client tasks that can be done tn, II: 174, 184 
Tracking file and, Il: 13-14, 16, 17 titles for, I: 105 
Contact People restriction 1n, II: 13 update set, I: 62 
deleting, II: 13 PRINT SETUP command, [: 99-100 
formats and selection criteria for, II: 19 for mailing labels, II: 8 
Reference attribute in, Il: 14, 17 Print style, I: 104 
removing relationship between Client Tracking Prompt line, I: 19; Il: 161 
file and, Il: 11, 13 issuing commands and, I: 20 
seeing all information in, II: 9 PY function, II: 144 
used by itself, Il: 6 
PFS:File files, II: 24, 34-40 Q 


Physical device, [: 104 
Planning a database. See Database—designing a 
+ Inf (+ Infinity), II: 234 


Quick Reference Card, I: 18 


PMT function, II: 144 R 
Power failure, [I: 205 Range constraints. See Cross-file range 
Pre-printed forms, |: 102, 106-7 constraints 

in Format mode, I: 126-29, 134 Ranges, in selection forms, I: 71-72: Il: 126-27 
Present value of an ordinary annuity, RECOMPUTE command (Recompute utility), 

Il 144 I: 56-57; I: 157, See also UTWLITIES. 

(PREVIOUS) key, I: 21; II: 152, 153 RECOMPUTE command 
Previous-Select selection criteria, |: 80 Ctrl-U for, Il: 170 
Previous-Update format, |: 61 in Edit mode, II: 97 
Previous-View format, |; 38 efficiency considerations and, II: 103-8 
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how to use, II: 96-97 
maintained attributes with, I: 177-78 
with selection criteria, II: 95-97 
when to use, II: 93-96 
to change the type of an attribute, II; 95-96 
to initialize new attributes, II: 93-94 
to make a derived attribute primitive, LI: 94, 
103-7 
to perform bulk updates, II: 94-95 
to update maintained attributes, Il: 94 
when to use, II: 93-96 
Record cursor, [: 32 
Record delimiter, in Convert mode, Il: 70, 74 
Records 
attributes of. See Attributes 


creating, I: 47-48, 51-54. See also Update mode 


definition of, I: 14, 138 
parent, I: 156, 157 
related, viewing, I: 76; Il: 109 
update set of, I: 50, 62 
working set of, I: 32 
REDEFINE-ATTRIBUTE command, I: 168 
in Client Tracking system, II: 12, 13 
REDEFINE-FILE command, |: 167 
in Client Tracking system, II: 11-13 
Reference attribute, in People file, Il: 14, 17 
Related records, viewing, I: 76; Il: 109 
Relationships, I; 15, 149-53 
defining (creating), I: 180-82 
with derived attributes, I: 103, 106-7 
with indexed attributes, Il: 101-2 
definition of, I: 149 
numbers and, II: 110-11 
range constraints and, [: 152-53 
re-establishing, Il: 12 
removing, [: 181 
in Client Tracking system, II: 11, 13 
sharing information with, I: 150-51 
between subfiles and parent files, 1: 157-58 
REM function, II: 136 
REMOVE command, II: 189, 196 
REMOVE-RELATIONSHIP command, I: 181] 
in Client Tracking system, II: 11, 12 
REORGANIZE command, II: 81, 86-87 
Repeating group of attributes, [: 158 
REPORT CALCULATE command, I: 93-94 


REPORT command, options paired with, I: 85-86 


Report elements 
definition of, I; 92 
hiding and showing, I: 92-93 
REPORT FORMAT command, I; 113, 130-31, 133 
Reports (report formats), I: 29, 31-38, 85-95 
basic steps involved in, I: 95 
changing, I: 32 
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in Client Tracking system, IL: 8-9, 19-20 
columnar, I: 32-34 


designing custom formats, I: 94. See also Format 


mode 

detailed, I: 34-36 

efficient, Il: 112 

moving through, I: 32 

names of, I: 37 

Previous-View, |: 38 

printing, I: 99. See also Printing 

saving, I: 36-37 

sorted, I: 38-39 

space requirements for, II: 236 

subtotals in, I: 88-91 

titles for, I: 105 

totals in, Ll: 86-88 

Update, |: 60-62 

using, I; 37-38 

View, I: 38, 41 
Reset string, I: 104 
RESTORE command, Il: $1 
Restoring backup files, II: 81, 84-86 
Restrict values to file field, II: 128 
Ringing bell with error messages, |: 192 
Rolodex Desk Top File, I: 5; Ik 6 
ROUND function, II: 137 
(RUB-WORD) key, I: 21; Il: 150, 153, 164 
Running Cornerstone, I: 13-14. See also 

Installation procedures 
problems with, Il 206 


S 


Sales database, II; 42 
Line Items subfile in, Il: 43-46, 55, 60 
Sales Tracking file in, Il: 55-60 
Sales Tracking file, I: 55-60 
Sample Database, I: iui, 5, 24 
recopying, to a hard disk, Il: 197 
SAVE FORMAT command, I: 37, 92, 131 
for printing instructions, I: 102 
SAVE SELECTION-CRITERIA command, I: 79 
Saving space 
on a hard-disk system, Il: 201-2 
on high-density diskettes, II: 200-1 
on a two-diskette system, II: 198-201 
Scientific notation, I: 175 
Screen 
color or monochrome, I: 192; Il: 163 
switches for setting colors, II: 192-94 
organization (layout) of, I: 19; If: 161-62 


(SCROLL-FORWARD) (or (PAGE-BACKWARD)) key, 


Il: 154 
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Scroll(ing) 

horizontal amount of, I: 191 

in View mode, [: 31, 32 

SDF (Standard Data Format) files, |! 
dBASE III file conversion and, II: 41 
truncation and spillover errors and, Il: 73 
SECONDS function, II: 142 

SELECT ALL command, to unsort records, II 
SELECT BY-FORM command, |: 58, 65-68; II 
SELECT command. See Select mode 


SELECT FLAGGED (or UNFLAGGED) command, | 


Select format, |: 80-81 

Selection 

indexes and, II: 101, 109 

processing and display during a, II: 110 

Selection criteria 

for backing up a subset of a file, Il: 83 

in Chent Tracking system, II: 8-9, 19-20 

format for displaying, I: 80-81 

printing, I: 82 

report formats and, I: 81 

saving, I: 79-80 

space requirements for, Il: 237 

status line display of number of records that 
meet, I: 69 

with RECOMPUTE command, II: 95-97 

Selection expressions, |: 70-75; Il: 124-28 

EMPTY (empty records), I: 73; II: 127 

entering, II: 124-28 

exact match, I: 70; Il: 124 

literal interpretation of, II: 128 

NOT (negation of a criterion), I: 74; Il: 127 


NOT EMPTY (non-empty records), I: 73; Il; 127 


(OPTIONS) key and, II: 156 

ranges, I: 71-73; Il: 126-27 

wild card (+), I: 73; Ilr 125 

Selection forms, [: 65-81. See also 
Selection criteria 

AND-FORM, I: 77-78 

entering values in, I: 67-69 

expressions that can be entered into, See 
Selection expressions 

multiple, I: 76-78 

negating, I: 78 

OR-FORM, I; 76-78 

properties of, I: 68-70 


Select mode (SELECT command), J: 17, 65-82 


See also Selection forms 
AND-FORM command in, [: 77-78 
for backing up a subset of a file, Il: 83 
CALCULATE command in, I: 75 
commands in, Il: 179 
display of selection criteria in, I: 80-81 
efficient formats in, I: 112 
examples of, l: 65-66 


3, 61-64 


flagged records in, L 67 

FORMAT command in, I: 113 

OR-FORM command in, I: 76-78 

PRINT command in, [: 82, 108 

tasks that can be done in, Ik: 174, 179 
SET-CHARAC command, |: 52, 120-23 

Ctrl-R for, Il: 170 

for mailing labels, I; 105 
SETUPHD.BAT file, II: 201-2 

terminating batch job, II: 189-90 


SHORT-FORM option, With DEFINE-NEW-ATTRIBUTE 


command, I: 168-70 
SHOW command, |: 86, 93 
SORT command, |; 39-41 


in View mode versus Backup mode, II: 88 


Sorting, |: 38-41 
In ASCENDING Or DESCENDING order, I: 41 
backup files, Il: 82-83, 88 
efficiency techniques and, II: 110 
enumerated values, II: 119 
indexing attributes and, II: 102, 110 
numeric values of type String, II: 117 
subtotaling and, I- 90-91 
Space. See also Disk space; Saving space 
“Disk full” error message and, II: 207 
(SPACE), to select a command, II: 164 
Speed. See Efficiency considerations 
Spillover, Il: 73 
Spreadsheet files. See 1-2-3 files 
SQRT function, Il: 137 
/s (system) switch, II: 194 


“Stack memory space exhausted,” I]; 207 


STANDARD-DEVIATION function, I: 91 
START-OF command, II: 157 


Start-up procedures. See Installation procedures; 


Running Cornerstone 
Status history, display of, I: 191 
Status line 
bottom, I: 19; II: 162 
for Edit mode, Il: 149 
top, I: 19; II: 162 
STDEV function, II: 134 
Storage of values, I]: 233-36 
String attributes, default width of, [: 19] 
String constant, IJ: 115 
String data type, I: 142 
conversion of, Il: 76 
STRING function, I: 159, 160; Il: 145 
appending data to a file and, II: 89 
String functions, II: 145 
String values 
entering, II: 115-18 
ranges for, Il: 126 
storage of, II: 233 
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Subattributes, |: 15 
definition of, I: 156 
sorting on the basis of, I: 41 
Subfile level, in Define mode, |: 164, 183 
printing at, I: 185 
Subfiles 
definition of, I: 156 
planning a database and, |: 155-58 
relationship between a file and its, I: 157-58 
in Sales database, II: 43-46 
viewing, [: 43 
Subforms, I: 116 
DETAILED and COLUMN commands and, I; 125 
entering values in, II: 151-52 
inserting lines in, I; 124, 133 
manipulating, I; 125-26 
Subrecords 
attributes of, [: 143, 155-56 
bullets for, I: 132 
defining (creating), I: 57, 182-83 
definition of, [: 15, 156 
entering values tn, I: 22 
examples of, I: 155-57 
planning a database and, I: 155-58 
properties of, I; 157 
storage of, Il; 235-36 
when to use, I: 158 
SUBSTRING function, II: 145 
SUBTOTAL command, |: 86, 88-90 
Subtotals 
in Format mode, I; 130 
grouping attributes for, I: 89 
in reports, I: 88-90 
sorting and, I: 90 
SUM function, I: 91; Il: 134 
Summary forms, I: 130 
Switches for setting colors, Il: 192-94 
SY000000.DBF, II: 240 
Symphony, II: 42, 45, 47 
“System cannot find the file called 
MS000000.DBF..., The,” II: 206 
System files 
copying, II: 191 
names of, [I: 239 


mn 


TEXT_DAY_OF_ WEEK function, Il: 139 


TEXT files, Il: 65, 70-71 

TEXT MONTH function, II; 16, 140 

THIS, entering dates with, Il: 121-23 

Tickler format, in Client Tracking file, 
II: 9, 20 


Time functions, If: 141-42 


Times 


data type for, I: 142 
conversion of, II: 77 
display characteristics for, I: 176 
entering values for, Il: 123-2 
expressions that can be entered for, I: 144 


storage of, Il: 235 


Titles 


in Format mode, I: 130, 132 
for reports, I: 105 


TMxxxxxx.DBF, II: 241 
TODAY (data entry expression), I: 144, 147 


I]; 140 
TODAY function, II: 140 
Top level, |: 163 
printing at, I: 185 
Top status line, I: 19; Ik 162 
TOTAL command, |: 86-89 
aggregate functions available with, I: 87-88, 91 
Totals 
in Format mode, I: 130 
in reports, I: 86-88 
Truncation, ll: 73 
Two-diskette system 
converting files in, Il: 28, 34 
copying Sales database on a, Il: 42 
customizing batch file for, If: 192, 194, 195 
installing Client Tracking system on a, Il: 3-4 
installing Cornerstone on a, I: 13 
saving space on a, II: 198-201 
space requirements for, Il; 236 
/s switch in, Il: 194 
Type-in style, I: 190; Il; 150 
Types of data. See Data types 
Typing commands, II: 163-64 


U 


UNDELETE command, I: 59-60 
Underbars, in Format mode, I: 114, 133 
UNIQUE _ ID function, II: 137 
Unique values, |; 53, 152, 172 
efficiency techniques and, II: 111-12 
indexing attributes with, II: 102 


“Unrecoverable read (or write) error,” I]: 205 


UPDATE ALL command, I: 50, 58 
UPDATE command, options paired with, Lk: 50 


UPDATE CURRENT-RECORD command, I: 49, 50, 58 


UPDATE FLAGGED (or UNFLAGGED) command, 
I: 50, 58 
Update format, |: 60-62 
saving and using, I: 61 
tips for designing, I: 62 





258 Index 


Update mode, I: 17, 47-62 
changing existing records 1n, |: 51, 58 
commands in, Il: 178 
copying values from previous records in, I: 54 
creating records in, I: 47-48, 51-54 
creating subrecords in, [: 57 
default format in, I: 60-62 
deleting records in, I: 58-60 
derived values in, I: 52, 54 
EDIT command in, I: 51 
efficient formats in, If: 112 
examples of uses of, I: 47- 
FORMAT command in, I: 113 


19 


initial values in, I; 55-56 
moving from record to record in, I: 50 
Previous-Update tormat in, |: 61 
PRINT command in, I: 62, 108 
recomputing initial values in, I: 56-57; Il: 94-95 
saving and using formats in, I: 61 
tasks that can be done in, II: 174, 178 
undeleting records in, I: 59-60 
update set in, I: 50 
viewing files at another level and, I: 43, 51 
UPDATE NEW-RECORD command, I: 47, 50, 51 
Update set, |: 50 
deleting records in, I: 58 
printing, I: 62 
USE command, in Select mode, I: 79 
USE FORMAT command, I: 37-38, 81, 92 
in Client Tracking system, Il: 8, 9 
for mailing labels, II: 8 
USE SELECTION-CRITERIA command, |: 79 
for mailing labels, II: 8 
/u (use) switch, Il: 195 
Utilities, overview of, I: 193-94 
UTILITIES BACKUP/RESTORE command, I: 193. 
See also Backup utility 
UTILITIES CONVERT command, I: 193; II: 26. 
See also Convert utility 


UTILITIES RECOMPUTE command, |: 57, 194; II: 93. 


See also RECOMPUTE command 
in Client Tracking system, II: 14 


Vv 


Values, I: 14, 140 
allowed and disallowed, I; 23 
canceling, and returning to original value, I: 23 
changeable, I; 173 
checking validity of, I]: 150, 152 
constraints on. See Constraints 
copying, I: 54; Il: 157 
derived. See Derived attributes (or values) 
entering. See Entering—values 


enumerated. See Enumerated \ ilues 
initial. See Initial values 
mandatory, I: 172 
minimum and maximum, I: 53, 173 
multiple. See also Multi-valued attributes 
entering, I: 22, 51-52; Il: 15] 
in selection forms, I: 68-69 
storage of, Il: 233-36 
unique, I: 53, 152, 172 
VARIANCE function, I: 91; Ik 135 
VIEW command, I: 42-43 
in View mode or Update mode, I: 76 
View format, [: 38, 41 
in Client Tracking system, II; 19, 20 
sorted reports and, II: 110 
View mode, I: 17, 29-44 
changing display formats in, I: 32 
columnar reports in, I: 32-34 
commands in, Il: 176-77 
default display format in, I; 38, 41 
detailed reports in, I: 34-36 
efficient formats in, Il: 112 
entering, I: 30-31 
flagging records in, I; 67 
formats in. See Reports (report formats) 
functions of, I: 29 
leaving, I: 31, 43 
menu in, I: 30, 44 
Prevtous-View format in, I: 38 
saving formats in, I: 36-37 
scanning your data in, I: 31-32 
screen display in, I: 30-31 
selecting existing records to update in, I: 58 
sorting records in, I: 38-41; Il: 110 
subfiles in, I: 43 
tasks that can be done in, II: 174, 176 
UPDATE command in, I: 58 
UPDATE NEW-RECORD command tn, I: 51 
using saved formats in, I: 37-38 
viewing other files in, I: 29, 42-43; II: 109 
Visicalc, II: 42, 60 
VOLIDOvn.Bvn, II: 241 


WwW 


Wild card (*) selection, I: 70-71, 73; Il: 125 
Window, menu, II: 161 

(WINDOW-LEFT) (or (WINDOW-RIGHT)) key, IJ: 154 
Word processing programs, I: 107-8 

Working set, I; 32 

“Write protect error writing drive B,” II: 191 
/w (wait) switch, II: 195, 199 
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YEAR function, II: 140 
~— zZ 


Zero for numbers less than one, [: 175 
ee Zeros, leading, II: 117 
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